노드(Node)의 개념과 구조

n8n에서 노드는 자동화의 핵심이 되는 가장 기본적인 단위입니다. 이 장에서는 노드가 무엇인지, 어떤 구조로 이루어져 있는지, 그리고 실제 워크플로우에서 노드가 어떻게 연결되어 동작하는지 자세히 살펴봅니다.

노드란 무엇인가?

노드는 n8n에서 하나의 작업을 담당하는 블록입니다. 마치 레고 블록처럼 각각의 노드는 특정 기능을 수행하며, 여러 노드를 조립하듯 연결해 원하는 자동화 흐름(워크플로우)을 만들 수 있습니다. 예를 들어, 이메일을 보내거나 데이터를 변환하는 등 다양한 역할을 담당합니다.

n8n은 이러한 노드 기반 구조를 바탕으로 ’노드 기반 자동화 도구’라고 불립니다. 노드는 데이터 처리, 외부 서비스 연동, 조건 분기, 반복 처리 등 다양한 기능을 제공합니다.

노드의 주요 구조와 데이터 흐름

n8n에서 노드는 다음과 같은 구조와 특징을 가집니다.

  • 입력(Inputs)과 출력(Outputs): 대부분의 노드는 입력 데이터를 받아 처리한 후 결과를 출력합니다. 이 데이터는 다음 노드로 전달되어 워크플로우 전체의 흐름을 만듭니다.
  • 데이터 구조: 노드 간 데이터는 항상 “객체의 배열(배열 안에 여러 개의 JSON 객체)” 형태로 전달됩니다. 각 객체는 key-value 쌍으로 정보를 담고 있으며, n8n 내부에서는 이를 ’아이템(items)’이라고 부릅니다.
  • 설정 옵션: 각 노드는 고유의 설정 화면을 제공하며, 입력값, 조건, 인증 정보 등 다양한 옵션을 지정할 수 있습니다.

예시) 두 명의 연락처 정보를 담은 데이터 구조

[
  { "json": { "name": "홍길동", "email": "hong@test.com" } },
  { "json": { "name": "김철수", "email": "kim@test.com" } }
]

이 구조는 n8n의 모든 노드에서 기본적으로 사용하는 데이터 포맷입니다.

노드의 종류와 역할

n8n의 노드는 그 역할에 따라 여러 유형으로 나눌 수 있습니다.

  • 트리거(Trigger) 노드: 워크플로우의 시작점이 되는 노드. 예를 들어, Webhook, Schedule 등이 있습니다. Gmail App Trigger는 특정 메일 수신 시 동작할 수 있으며 n8n Form Trigger는 n8n에서 제공하는 웹폼에 사용자가 데이터를 입력해 제출할 때 워크플로우가 실행됩니다.

  • 액션(Action) 노드: 특정 작업을 실행하는 노드. 예: 이메일 발송, 데이터베이스 저장 등을 수행합니다. HTTP 요청전송 노드는 외부 API와 통신해 데이터를 주고 받거나 작업을 수행합니다. execution commad노드는 로컬 시스템 명령어를 실행합니다.

  • 조건(Condition) 노드: 데이터의 조건을 판별해 분기 처리를 하는 노드.

  • 데이터(Data) 노드: 데이터를 변환, 가공, 필터링하는 역할을 하는 노드. aggregate 는 여러 데이터 항목을 합산, 평균, 그룹화를 진행하고 Sort는 데이터를 특정 필드 기준으로 정렬합니다. merge는 여러 데이터 스트림을 하나로 합치거나 두개의 데이터 집합을 join할 때 사용합니다.

  • 유틸리티(Utility) 노드: 워크플로우의 흐름을 보조하는 다양한 기능을 수행합니다. Convert to File 노드는 n8n에서 입력 데이터를 다양한 파일 형식으로 변환해 바이너리 파일로 출력하는 데 사용됩니다. Wait 노드 는 지정한 시간(초, 분, 시간 등) 동안 워크플로우 진행을 일시 정지합니다.

  • 코드(Code)와 AI 에이전트 노드: 코드 노드는 JavaScript와 python 코드를 직접 작성해 복잡한 로직이나 맞춤형 처리를 할 수 있는 노드입니다. AI 에이전트 노드는 GPT 등 AI 기능을 활용한 자동화에 특화된 노드입니다.

노드 연결과 워크플로우 완성

n8n에서는 드래그 앤 드롭 방식으로 노드를 연결하여 데이터 흐름을 설계합니다. 예를 들어, “Webhook → 데이터 변환 → 조건 분기 → 이메일 발송”과 같은 순서로 노드를 연결할 수 있습니다.

실전 예제

  • n8n form 노드로 외부에서 데이터를 받는다.
  • Set 노드로 데이터를 가공한다.
  • IF 노드로 조건을 판별한다.
  • Email 노드로 결과를 발송한다.

이처럼 노드를 조립하듯 연결하면, 복잡한 자동화도 손쉽게 구현할 수 있습니다.

확인문제

  1. n8n에서 노드는 어떤 역할을 하며, 데이터는 어떤 구조로 전달되나요?
  2. 트리거, 액션, 유틸리티 노드의 차이점을 간단히 설명해보세요.

주요 용어

  • 노드(Node): n8n에서 하나의 작업을 담당하는 기본 단위.
  • 워크플로우(Workflow): 여러 노드가 연결되어 자동화 작업을 수행하는 흐름.
  • 트리거(Trigger): 워크플로우의 시작을 담당하는 노드.
  • 액션(Action): 특정 작업을 실행하는 노드.
  • 유틸리티(Utility): 데이터 흐름을 보조하는 다양한 기능의 노드.
  • 아이템(Item): 노드 간 전달되는 데이터의 한 단위(객체).