n8n 노드 유형
n8n 노드 유형 (Node types)
n8n의 내장 노드와 그 크레덴셜을 설명하는 참조 문서입니다. 노드가 '무엇을 하는지'에 따라 어떻게 분류되는지, 그리고 워크플로우에 어떤 식으로 들어오는지 파악하는 데 도움이 되는 내용이에요.
이 섹션은 n8n의 모든 내장 노드와 그 크레덴셜을 다루는 노드 라이브러리입니다.
노드 연산: 트리거와 액션 (Triggers and Actions)
워크플로우에 노드를 추가하면 n8n이 사용 가능한 연산(operation) 목록을 보여줍니다. 연산이란 노드가 수행하는 일, 예를 들어 데이터를 가져오거나 보내는 동작 하나를 말해요.
연산에는 두 종류가 있습니다:
- **트리거(Trigger)**는 서비스의 특정 이벤트나 조건에 반응해 워크플로우를 시작해요. 트리거를 선택하면 n8n이 그 트리거 연산이 미리 선택된 상태로 트리거 노드를 워크플로우에 추가합니다. n8n에서 노드를 검색할 때 트리거 연산에는 번개 아이콘이 붙어 있어요.
- **액션(Action)**은 워크플로우 안에서 특정 작업을 나타내는 연산이에요. 데이터를 조작하거나, 외부 시스템에서 연산을 수행하거나, 다른 시스템에서 이벤트를 발생시키는 데 씁니다. 액션을 선택하면 n8n이 그 액션 연산이 미리 선택된 상태로 노드를 워크플로우에 추가해요.
핵심 노드 (Core nodes)
핵심 노드는 액션이 될 수도 트리거가 될 수도 있어요. 대부분의 노드가 특정 외부 서비스에 연결되는 데 비해, 핵심 노드는 로직·스케줄링·제네릭 API 호출 같은 기능을 제공합니다.
클러스터 노드 (Cluster nodes)
클러스터 노드는 함께 동작해 워크플로우의 기능을 만들어내는 노드 그룹이에요. 단일 노드 대신 루트 노드 하나와 기능을 확장하는 서브 노드 하나 이상을 조합해서 사용합니다.
크레덴셜 (Credentials)
외부 서비스는 사용자를 식별하고 인증하는 방법이 필요해요. 이 데이터는 API 키 하나부터 이메일/비밀번호 조합, 여러 줄로 된 긴 프라이빗 키까지 다양할 수 있죠. n8n에서는 이런 데이터를 크레덴셜(Credential)[^3]로 저장합니다.
n8n의 노드는 그 크레덴셜 정보를 요청해서 사용할 수 있어요. 보안 레이어가 하나 더 있는데, 특정 접근 권한을 가진 노드 유형만 그 크레덴셜에 접근할 수 있습니다.
데이터 보안을 위해 크레덴셜은 데이터베이스에 암호화되어 저장돼요. n8n은 첫 실행 때 임의의 개인 암호화 키를 자동 생성해서 ~/.n8n/config 아래에 저장합니다.
크레덴셜 만들기·관리·공유에 대해 더 알아보려면 Manage credentials를 참고하세요.
커뮤니티 노드 (Community nodes)
n8n은 커뮤니티 노드를 지원합니다. 설치와 사용 방법은 Community nodes를 참고하세요.
나만의 커뮤니티 노드를 만들어 npm에 배포하고 싶다면 Create nodes에서 자세히 안내합니다.
다른 통합 주제는 Built-in nodes에서 확인할 수 있어요.
[^1]: n8n에서 노드는 워크플로우를 구성하기 위해 조합하는 개별 컴포넌트입니다. 노드는 워크플로우가 언제 실행될지 정의하고, 데이터를 가져오고·보내고·처리할 수 있게 하며, 흐름 제어 로직을 정의하고, 외부 서비스와 연결해 줍니다. [^2]: 트리거 노드는 특정 조건에 반응해 워크플로우를 실행하는 특별한 노드입니다. 모든 프로덕션 워크플로우는 언제 실행될지 결정하는 트리거가 최소 하나는 필요해요. [^3]: n8n에서 크레덴셜은 특정 앱·서비스에 연결하기 위한 인증 정보를 저장합니다. 사용자 이름과 비밀번호, API 키, OAuth 시크릿 등으로 크레덴셜을 만든 뒤 관련 앱 노드를 이용해 그 서비스와 상호작용할 수 있습니다.