n8n 소개
n8n은 노드를 연결하는 시각적 편집기를 중심으로 한 워크플로 자동화 플랫폼입니다. 각 노드는 트리거 또는 액션입니다. 웹훅, 일정, 스프레드시트의 새 행, Slack 메시지, API 호출 등이 있습니다. 기본 연동으로 부족하면 직접 작성한 JavaScript나 Python 코드 노드를 넣을 수 있습니다.
베를린의 한 회사가 개발하며 fair-code 라이선스로 배포됩니다. 소스가 공개되어 있어 자기 사업을 위해 직접 운영할 수 있지만, 서비스로 재판매하는 데는 일부 제한이 있습니다. 최근 버전에는 워크플로 중간에 언어 모델과 도구를 호출하는 AI 에이전트 노드가 추가되었습니다.
팀이 n8n을 직접 운영하는 주된 이유는 비용과 데이터입니다. 호스팅형 자동화 서비스는 보통 작업이나 실행 단위로 요금을 받지만, 자체 인스턴스는 서버 사양만큼만 제한되고 내부 시스템의 자격 증명이 외부로 나가지 않습니다.
주요 활용 사례
업무용 앱 간 연결
하나의 트리거로 새 주문을 스프레드시트에 복사하고, CRM 연락처를 만들고, 영업팀 채팅에 알리세요.
자사 제품을 위한 웹훅
별도의 백엔드 서비스를 만들지 않고도 결제 서비스나 양식의 이벤트를 받아 처리하세요.
업무 프로세스 속 AI 단계
언어 모델로 수신 이메일을 분류하고 각각을 알맞은 담당자나 대기열로 보내세요.
주문 후
서버가 처음 시작되면 n8n이 설치되고, 방화벽에서 열린 5678 포트로 게시됩니다. http://서버-주소:5678/ 로 접속하세요. 미리 정해진 로그인 정보는 없습니다. 이 주소를 처음 연 사람이 소유자 계정을 만들므로, 서버가 준비되면 바로 열어 주세요. 이후 연결할 서비스의 자격 증명을 추가하고 첫 워크플로를 만드세요.
n8n에 내 도메인과 HTTPS 적용
기본적으로 n8n은 서버 IP 주소에서 일반 HTTP로 응답합니다. n8n.example.com 같은 이름과 인증서를 적용하려면 DNS에서 해당 이름의 A 레코드를 만들어 서버의 IPv4 주소를 가리키게 한 뒤, 앞단에 Caddy를 두세요. Caddy는 무료 Let's Encrypt 인증서를 스스로 발급받고 갱신합니다. 아래 명령은 앱 서버에서 사용하는 Ubuntu 24.04 기준입니다.
패널에서 서버 방화벽의 TCP 80, 443 포트를 여세요. Caddy가 Let's Encrypt 인증서를 발급받고 사이트를 제공하는 데 필요합니다.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
n8n.example.com {
reverse_proxy 127.0.0.1:5678
}
EOF
systemctl reload caddyn8n도 자신의 공개 주소를 알아야 합니다. 그렇지 않으면 웹훅 URL과 로그인 쿠키가 계속 IP를 가리킵니다. /opt/n8n/compose.yml에서 N8N_HOST: n8n.example.com, WEBHOOK_URL: https://n8n.example.com/을 설정하고, N8N_PROTOCOL: https를 추가하고, N8N_SECURE_COOKIE를 "true"로 바꾼 뒤 docker compose up -d를 실행하세요. 그 전에 만든 웹훅은 외부 서비스에 이전 주소로 남아 있으니 그곳에서 수정하세요.
도메인이 동작하면 5678 포트에 직접 접속할 필요가 없습니다. /opt/n8n/compose.yml에서 "5678:…"를 "127.0.0.1:5678:…"로 바꾸고 docker compose up -d를 실행한 뒤, 방화벽에서 5678 포트를 제거하세요. 그러면 n8n은 HTTPS로만 접속할 수 있습니다.
n8n 업데이트
/opt/n8n/compose.yml의 이미지는 정확한 버전으로 고정되어 있어, 그냥 docker compose pull을 실행하면 같은 버전을 다시 받습니다. 업데이트하려면 image: 줄의 버전을 원하는 버전으로 바꾸고(먼저 릴리스 노트를 확인하세요), 이미지를 받아 컨테이너를 다시 만드세요. 데이터는 Docker 볼륨에 있어 그대로 유지됩니다.
n8n은 메이저 버전의 호환성이 깨지는 변경 사항을 릴리스 노트에 게시합니다. 여러 메이저 버전을 한 번에 올릴 때는 한 단계씩 진행하는 편이 안전합니다.
cd /opt/n8n
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dn8n 백업
패널에서 서버 전체의 매일 백업을 켤 수 있으며(요금제 가격의 +20%, 최근 7개 사본 보관), 그중 어느 사본에서든 서버를 복원할 수 있습니다. 그래도 앱 데이터를 파일로 따로 복사해 두는 것이 좋습니다. 다른 서버로 옮기거나 나머지를 모두 되돌리지 않고 복원할 수 있기 때문입니다.
n8n에 저장한 자격 증명은 /opt/n8n/.env의 키(APP_SECRET, n8n에는 N8N_ENCRYPTION_KEY로 전달)로 암호화됩니다. 백업할 때마다 이 파일의 사본을 함께 보관하세요. 키가 없으면 복원한 자격 증명을 복호화할 수 없습니다. n8n 자체 CLI로 워크플로와 자격 증명을 데이터 볼륨 안의 파일로 내보낼 수 있습니다.
cd /opt/n8n
docker compose exec n8n n8n export:workflow --all --output=/home/node/.n8n/backup-workflows.json
docker compose exec n8n n8n export:credentials --all --output=/home/node/.n8n/backup-credentials.json
cp .env /root/n8n-env-backup진행 방식
- 서버 주문 페이지에서 n8n을(를) 고르고, 메모리가 충분한 요금제를 선택하세요.
- 앱은 서버의 첫 시작 때 설치되며, 보통 몇 분이면 끝납니다.
- 패널에서 서버를 열면 주소와 로그인 정보가 있습니다.