프로덕션 요구 사항
n8n v2.47요약
직접 관리하는 프로덕션 n8n 배포를 실행하기 전에 데이터베이스, 운영 체제, 런타임, 스토리지, 배포 도구가 n8n의 요구 사항을 충족하는지 확인하세요. 빠른 시작을 찾고 계신가요? 이 섹션은 프로덕션에서 n8n을 실행할 때 적용됩니다.
직접 관리하는 프로덕션 n8n 배포를 실행하기 전에 데이터베이스, 운영 체제, 런타임, 스토리지, 배포 도구가 n8n의 요구 사항을 충족하는지 확인하세요.
빠른 시작을 찾고 계신가요? 이 페이지는 필요하지 않습니다. 원라인 설정은 Docker만 있으면 되며 데이터베이스와 스토리지를 대신 처리합니다. Docker Compose로 설치는 기본 제공 SQLite 데이터베이스로 시작하며, PostgreSQL은 선택 단계입니다. 프로덕션으로 전환하거나, 자체 PostgreSQL을 운영하거나, 큐 모드를 사용하거나, 쿠버네티스 또는 베어 메탈에 배포할 때 이 페이지를 사용하세요.
데이터베이스#
이 섹션은 프로덕션에서 n8n을 실행할 때 적용됩니다. 원라인 설정과 Docker Compose 가이드는 n8n의 기본 제공 SQLite 데이터베이스로 시작하며, 이는 테스트와 소규모 설정에 적합합니다.
n8n은 워크플로, 자격 증명, 실행 기록을 저장할 데이터베이스가 필요합니다.
- PostgreSQL: n8n은 프로덕션에서 지원되는 PostgreSQL 버전의 PostgreSQL을 권장합니다.
- SQLite: n8n은 큐 모드에서 SQLite를 지원하지 않으며, 다중 사용자 프로덕션 환경에서도 권장하지 않습니다.
- 데이터베이스 사용자 권한: n8n 데이터베이스 사용자는 데이터베이스에 연결하고, 구성된 스키마에서 객체를 사용 및 생성하고, 마이그레이션 중에 n8n의 테이블을 변경하거나 삭제할 수 있어야 합니다. 가장 간단한 설정은 n8n 사용자가 자신이 생성한 테이블을 소유하도록 하는 것입니다. 예시는 필요한 권한을 참조하세요.
PostgreSQL을 구성하는 환경 변수는 n8n의 데이터베이스 선택을 참조하세요.
운영 체제 및 런타임#
- 운영 체제: n8n은 프로덕션에 64비트 Linux 호스트를 권장합니다.
- Node.js: n8n 2.x에서는 npm 설치에만 Node.js가 필요합니다. Docker 및 쿠버네티스 설치에는 올바른 버전이 포함되어 있습니다. 지원되는 Node.js 버전은 npm으로 설치를 참조하세요. n8n 3.0부터는 npm 설치를 더 이상 지원하지 않으므로 Docker 기반 배포가 필요합니다. v3.0 호환성을 깨는 변경을 참조하세요.
스토리지#
원라인 설정과 Docker Compose 가이드는 n8n의 데이터를 Docker 볼륨에 저장하므로 별도로 스토리지를 설정할 필요가 없습니다. 두 설정 중 하나를 변경해 사용한다면 n8n 데이터용 볼륨을 유지하세요. 이 섹션은 프로덕션 배포와 스토리지를 직접 관리하는 큐 모드를 활성화한 배포에 적용됩니다.
이러한 배포에서는 다음을 계획하세요.
- n8n 데이터 디렉터리: n8n 데이터 디렉터리용 영구 볼륨입니다. 이 디렉터리에는 암호화 키와, 활성화한 경우 파일 로그가 저장됩니다. 또한 n8n 2.0부터 일반 모드의 기본값인 파일 시스템 모드의 로컬 바이너리 데이터도 저장됩니다.
- PostgreSQL 데이터: PostgreSQL을 직접 운영하는 경우 PostgreSQL 데이터용 영구 볼륨입니다.
- 큐 모드의 바이너리 데이터: 다른 스토리지 모드를 구성하지 않으면 n8n은 바이너리 데이터를 데이터베이스에 저장합니다. 라이선스에 해당 외부 스토리지 옵션이 포함되어 있다면 AWS S3 또는 Azure Blob Storage를 사용할 수 있습니다. 파일 시스템 스토리지를 사용하는 경우 바이너리 데이터를 처리하는 모든 메인 인스턴스, 워커, 웹훅 프로세서가 동일하게 구성된 경로에서 같은 공유 볼륨에 접근할 수 있어야 합니다. 데이터베이스 모드를 사용하면 PostgreSQL 데이터베이스의 크기가 늘어납니다. 라이선스에 외부 스토리지가 포함되어 있다면 큐 모드에서는 외부 스토리지를 사용하는 것이 좋습니다. 자세한 내용은 바이너리 데이터 처리를 참조하세요.
Redis#
이 섹션은 큐 모드를 활성화하는 경우에만 적용됩니다.
큐 모드에서 Redis는 메인 n8n 인스턴스와 워커 사이에서 대기 중인 실행의 큐 상태를 보관합니다. PostgreSQL은 워크플로와 실행 데이터를 보관합니다. Redis가 큐에 있던 작업을 잃어버리면 n8n은 PostgreSQL에서 이를 복원하지 않고, 영향을 받은 실행을 비정상 종료(crashed)로 표시합니다. 감수할 수 있는 작업 손실 정도에 맞게 Redis의 영속성과 가용성을 구성하세요. 메인 인스턴스와 모든 워커가 접근할 수 있는 Redis 인스턴스를 준비하세요. 연결 설정은 Redis 시작을 참조하세요.
네트워크#
이 섹션은 사용자나 외부 서비스에 노출하는 프로덕션 배포에 적용됩니다.
포트#
| 포트 | 구성 요소 | 용도 |
|---|---|---|
| 5678 | n8n | HTTP API, 에디터 UI, 웹훅입니다. N8N_PORT의 기본값입니다. |
| 5432 | PostgreSQL | 데이터베이스 연결입니다. PostgreSQL의 기본값입니다. |
| 6379 | Redis | 큐 모드의 큐 통신입니다. Redis의 기본값입니다. 관리형 서비스는 TLS에 다른 포트를 사용하는 경우가 많으므로 사용 중인 Redis 서비스의 포트와 TLS 설정을 사용하세요. |
| 5679 | n8n 태스크 브로커 | 외부 태스크 러너의 연결입니다. N8N_RUNNERS_BROKER_PORT의 기본값입니다. 브로커는 기본적으로 127.0.0.1에서 수신합니다. 러너가 루프백으로 연결할 수 없다면 N8N_RUNNERS_BROKER_LISTEN_ADDRESS를 러너가 접근할 수 있는 바인드 주소로 설정하세요. 이 포트는 비공개로 유지하고 러너만 접근하도록 제한하세요. |
방화벽 규칙#
최소한 다음과 같이 방화벽을 구성하세요.
- 메인 n8n 인스턴스와 워커가 PostgreSQL에 접근할 수 있어야 하며, 큐 모드에서는 Redis에도 접근할 수 있어야 합니다.
- 로드 밸런서 또는 리버스 프록시가 5678 포트에서 메인 n8n 인스턴스에 접근할 수 있어야 합니다.
- n8n이 워크플로에서 사용하는 외부 서비스에 접근할 수 있도록 아웃바운드 인터넷 접근이 가능해야 합니다. 워크플로가 내부 서비스만 호출하는 에어 갭 환경에서 n8n을 실행하는 경우에는 해당되지 않습니다.
- 사용자가 자신의 네트워크에서 로드 밸런서 또는 리버스 프록시를 통해 에디터 UI에 접근할 수 있어야 합니다.
- 웹훅을 호출하는 서비스가 웹훅 URL에 접근할 수 있어야 합니다. 호출하는 쪽이 외부에 있다면 인터넷을 통해 접근할 수 있어야 합니다.
- 메인 인스턴스를 둘 이상 실행하는 경우 로드 밸런서가 스티키 세션을 사용해야 합니다. 큐 모드 활성화를 참조하세요.
n8n 프로세스를 인터넷에 직접 노출하지 마세요. 앞단에 리버스 프록시나 로드 밸런서를 두세요.
DNS#
n8n.example.com 같은 호스트 이름이 로드 밸런서나 리버스 프록시를 가리키도록 DNS 레코드를 만드세요. 이 호스트 이름은 N8N_HOST, N8N_EDITOR_BASE_URL, N8N_WEBHOOK_URL 환경 변수에 사용합니다. N8N_HOST에는 호스트 이름(n8n.example.com)을 넣습니다. N8N_EDITOR_BASE_URL과 N8N_WEBHOOK_URL에는 전체 URL(https://n8n.example.com/)을 넣습니다. N8N_WEBHOOK_URL은 n8n 2.30.0부터 사용할 수 있으며, 이전 버전에서는 WEBHOOK_URL을 사용하세요.
리버스 프록시 뒤에서는 N8N_PROXY_HOPS도 설정하세요. 이 변수는 n8n이 클라이언트 IP와 프로토콜에 대해 전달된 헤더를 신뢰할지를 제어합니다. 프록시 뒤에서 n8n이 웹훅 URL을 구성하는 방법과 N8N_PROXY_HOPS를 설정하는 방법은 리버스 프록시로 웹훅 URL 구성을 참조하세요.
TLS#
호스트 이름에 대한 TLS 인증서를 준비하세요. n8n은 리버스 프록시나 로드 밸런서에서 TLS를 종료하는 것을 권장하며, 구성하면 인증서 갱신도 처리할 수 있습니다. n8n에 SSL을 설정하는 방법은 SSL 설정을 참조하세요. 쿠버네티스에서는 cert-manager가 인증서를 발급하고 갱신할 수 있습니다.
소프트웨어 의존성#
n8n을 배포하는 방식에 맞는 하위 섹션을 선택하세요.
Docker#
- 지원되는 버전의 Docker Engine 또는 Docker Desktop.
- Compose 기반 설정을 위한 Docker Compose v2 플러그인.
설치 단계는 Docker Compose로 설치를 참조하세요.
쿠버네티스#
- 공식 n8n Helm 차트가 지원하는 쿠버네티스 버전. 차트는
Chart.yaml에 지원 범위를 선언합니다. - 클러스터에 접근하도록 구성된
kubectl. - Helm 기반 배포를 위한 Helm.
- AWS Load Balancer Controller와 같은 지원되는 인그레스 컨트롤러.
베어 메탈#
기능 제공 여부
npm을 사용한 베어 메탈 설치는 n8n 2.x에서 사용할 수 있습니다. n8n 3.0부터는 npm 설치를 더 이상 지원하지 않으므로 Docker 기반 배포가 필요합니다. v3.0 호환성을 깨는 변경을 참조하세요.
- 지원되는 Node.js 버전. npm으로 설치를 참조하세요.
- Node.js와 함께 제공되는 npm.
- PM2 또는
systemd와 같은 프로세스 관리자. - SSL 종료를 위한 NGINX 또는 Caddy와 같은 리버스 프록시.
배포 전 체크리스트#
프로덕션 배포에 이 체크리스트를 사용하세요. 큐 모드를 사용하지 않는 경우의 Redis나 외부 스토리지를 사용하지 않는 경우의 외부 스토리지처럼 설정에 해당하지 않는 항목은 건너뛰세요.
- Business 또는 Enterprise 기능을 사용하는 경우 라이선스 키를 확보하고 활성화할 준비가 되어 있습니다.
- 지원되는 버전의 PostgreSQL을 준비하고 접근할 수 있습니다.
- Redis를 준비하고 접근할 수 있습니다(큐 모드만 해당).
- 외부 스토리지를 사용하는 경우 외부 스토리지 버킷 또는 컨테이너를 만들었습니다.
- DNS 레코드가 로드 밸런서를 가리킵니다.
- TLS 인증서를 준비했거나 cert-manager를 구성했습니다.
- 방화벽 규칙을 구성했습니다.
- 영구 볼륨을 사용할 수 있습니다.
- 암호화 키를 생성하여 안전하게 보관했고 모든 n8n 인스턴스에서 같은 값으로 설정했습니다.
openssl rand -hex 32를 실행해 생성할 수 있습니다. - 백업 전략을 결정했습니다.