12화. n8n — 반복 업무를 워크플로로. 자동화의 자동화

매일 아침 하는 일, 새 데이터가 오면 복사해서 보내는 일, 폼이 들어오면 알려주는 일. 이런 반복 업무를 코드 없이(혹은 조금만 써서) 워크플로로 묶어주는 도구가 n8n이다. Zapier·Make 같은 클라우드 자동화의 셀프호스팅 버전인데, 달라지는 것은 요금이 아니라 모든 데이터와 실행 기록이 내 서버에 있다는 것이다.

이런 때 유용합니다

• 매일 같은 조회·정리·보고를 손으로 하고 있을 때. 스케줄 트리거로 정해진 시간에 알아서 돌린다.
• 여러 서비스를 잇는 연결고리가 필요할 때. 폼 제출 → 데이터베이스 저장 → 알림 발송 같은 흐름을 노드 연결로 만든다.
• 웹훅을 받을 주소가 필요할 때. 외부 시스템의 이벤트를 n8n 웹훅으로 받아 원하는 동작을 실행한다.
• 크론(cron)은 관리하기 부담스러울 때. 실행 이력·실패 알림·재실행 버튼이 붙어 있는 크론이라고 보면 된다.
• Zapier의 작업 수 요금이 부담되기 시작할 때. 셀프호스팅은 실행 횟수 무제한이다.

필요한 것은 서버와 컨테이너 하나, 그리고 조금의 논리적 사고다.

n8n은 어떤 프로그램인가

n8n은 노드를 연결해 워크플로를 만드는 오픈소스(정확히는 fair-code) 자동화 플랫폼이다. 화면에서 박스(노드)를 연결하면 그 순서대로 작업이 실행되는 방식이라, 프로그래밍 경험이 없어도 흐름을 만들 수 있다. 복잡한 로직이 필요하면 중간에 코드 노드(JavaScript·Python)를 넣을 수도 있다.

라이선스는 fair-code 방식이라 소스가 공개되어 있고 내부 업무용 사용은 자유롭다. 이 서비스를 파 selling하는 SaaS를 만드는 것만 제한된다 — 자기 서버에서 쓰는 데에는 영향이 없다.

전체 구성

flowchart LR
    T1["스케줄 - 정해진 시간"]
    T2["웹훅 - 외부 이벤트"]
    subgraph SRV["Docker 서버"]
        N["n8n 컨테이너"]
        DB[("n8n-data - 워크플로·실행이력")]
    end
    X["외부 API · 서비스"]
    AL["알림 - 메신저 · 메일"]
    T1 --> N
    T2 --> N
    N -->|HTTP 요청| X
    N --> AL
    N --> DB

설치 방법

1단계 — 컨테이너

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    environment:
      GENERIC_TIMEZONE: "Asia/Seoul"        # 스케줄 트리거의 기준 시간
      WEBHOOK_URL: "https://n8n.example.com/"  # 외부에서 호출할 주소
    volumes:
      - /opt/docker/n8n/data:/home/node/.n8n
    ports:
      - "5678:5678"

GENERIC_TIMEZONE을 설정하지 않으면 스케줄이 UTC로 돌아 "9시에 걸었는데 왜 새벽에 실행되지?"가 된다. WEBHOOK_URL은 웹훅 기능을 외부에 공개할 때 필요한 주소다.

2단계 — 도메인 붙이기

웹UI용 도메인을 프록시 뒤에 붙이고 HTTPS로 서비스하자. 웹훅을 외부 서비스가 호출하려면 외부 접속 경로가 필수이고, 로그인 계정 생성도 여기서 한다.

3단계 — 첫 워크플로

가장 만족감이 큰 첫 예제: 스케줄 트리거 → HTTP Request → 조건 분기 → 알림. 예를 들어 "매일 아침 9시에 외부 API에서 데이터를 가져와, 값이 비정상이면 메신저로 알림"이다.

1. 워크플로 생성 → 트리거로 "Schedule" 추가(매일 09:00)
2. "HTTP Request" 노드로 데이터 조회
3. "IF" 노드로 조건 판단
4. 참인 경로에 알림 노드(메신저·메일) 연결

화면에서 박스 네 개를 이어 붙이는 것으로 끝나고, 실행 이력 탭에서 매 실행의 입력·출력을 그대로 볼 수 있어 문제 추적이 쉽다.

운영하며 쌓은 것들

실행 이력이 n8n의 진짜 가치다. 크론으로 돌리던 스크립트는 실패해도 무엇이 잘못됐는지 알려면 로그를 뒤져야 한다. n8n은 실행 목록에서 실패 건을 클릭하면 어느 노드에서, 어떤 입력으로, 어떤 응답을 받았는지 그대로 보인다. 실패한 노드부터 재실행하는 기능도 있다.

노드가 없다고 좌절하지 말자. 수백 개의 통합 노드가 있지만 결국 빠지는 서비스가 있다. 그럴 때 HTTP Request 노드면 대부분 해결된다 — REST API를 주는 서비스라면 전부 연결 대상이다.

백업은 data 폴더 하나다. 워크플로·실행 이력·크레덴셜이 전부 n8n-data 폴더(SQLite)에 들어있으므로, 이 폴더를 주기 복사하면 백업이 끝난다.

핵심 서비스와의 연결은 웹훅으로. 홈어시스터트 같은 자동화 허브의 이벤트를 n8n 웹훅으로 받아 복잡한 로직을 처리하는 식으로, 이 시리즈의 다른 서비스들과 조합이 자유롭다.

트러블슈팅 정리

자주 묻는 질문

Zapier·Make 대신 꼭 이걸 써야 하나?

실행 횟수가 늘어나면 클라우드 자동화의 요금이 눈에 띄게 커진다. n8n은 실행 무제한에 데이터가 내 서버에 있으니, 트래픽이 있는 업무 자동화라면 셀프호스팅 쪽이 경제적이다. 대신 서버 유지와 업데이트는 내 몫이다.

코딩을 못 해도 쓸 수 있나?

노드 연결만으로 대부분의 워크플로가 만들어진다. 고급 로직(데이터 가공, 조건 계산)만 코드 노드를 쓰면 되고, 그마저도 예제를 복사하는 수준에서 시작할 수 있다.

홈어시스턴트 같은 자동화 허브와 뭘 나눠 쓰면 되나?

기기 제어·집안 자동화는 HA, 웹 API를 오가는 업무 자동화는 n8n이 담당하는 분업이 깔끔하다. 둘 다 웹훅이 있으니 서로 호출하는 연결도 쉽다.

서버 한 대로 충분하다 연재 목차 — 시리즈 소개 · 1화. Home Assistant · 2화. Frigate + go2rtc · 3화. Seafile 13 · 4화. Immich · 5화. Vaultwarden · 6화. Mailcow · 7화. MinIO · 8화. Umami · 9화. GitLab · 10화. Portainer · 11화. Komodo

웹훅·스케줄 워크플로를 실제 업무로 운영 중인 구성입니다.