InfoGrab DocsInfoGrab Docs

프로덕션 요구 사항

요약

직접 관리하는 프로덕션 n8n 배포를 실행하기 전에 데이터베이스, 운영 체제, 런타임, 스토리지, 배포 도구가 n8n의 요구 사항을 충족하는지 확인하세요. 빠른 시작을 찾고 계신가요? 이 섹션은 프로덕션에서 n8n을 실행할 때 적용됩니다.

직접 관리하는 프로덕션 n8n 배포를 실행하기 전에 데이터베이스, 운영 체제, 런타임, 스토리지, 배포 도구가 n8n의 요구 사항을 충족하는지 확인하세요.

Note

빠른 시작을 찾고 계신가요? 이 페이지는 필요하지 않습니다. 원라인 설정은 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 Compose로 설치를 참조하세요.

쿠버네티스#

  • 공식 n8n Helm 차트가 지원하는 쿠버네티스 버전. 차트는 Chart.yaml에 지원 범위를 선언합니다.
  • 클러스터에 접근하도록 구성된 kubectl.
  • Helm 기반 배포를 위한 Helm.
  • AWS Load Balancer Controller와 같은 지원되는 인그레스 컨트롤러.

베어 메탈#

Note

기능 제공 여부

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를 실행해 생성할 수 있습니다.
  • 백업 전략을 결정했습니다.

관련 리소스#

프로덕션 요구 사항

n8n v2.47
원문 보기

요약

직접 관리하는 프로덕션 n8n 배포를 실행하기 전에 데이터베이스, 운영 체제, 런타임, 스토리지, 배포 도구가 n8n의 요구 사항을 충족하는지 확인하세요. 빠른 시작을 찾고 계신가요? 이 섹션은 프로덕션에서 n8n을 실행할 때 적용됩니다.

직접 관리하는 프로덕션 n8n 배포를 실행하기 전에 데이터베이스, 운영 체제, 런타임, 스토리지, 배포 도구가 n8n의 요구 사항을 충족하는지 확인하세요.

Note

빠른 시작을 찾고 계신가요? 이 페이지는 필요하지 않습니다. 원라인 설정은 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 Compose로 설치를 참조하세요.

쿠버네티스#

  • 공식 n8n Helm 차트가 지원하는 쿠버네티스 버전. 차트는 Chart.yaml에 지원 범위를 선언합니다.
  • 클러스터에 접근하도록 구성된 kubectl.
  • Helm 기반 배포를 위한 Helm.
  • AWS Load Balancer Controller와 같은 지원되는 인그레스 컨트롤러.

베어 메탈#

Note

기능 제공 여부

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를 실행해 생성할 수 있습니다.
  • 백업 전략을 결정했습니다.

관련 리소스#