큐 모드 환경 변수

요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 필요에 따라 다양한 모드로 n8n을 실행할 수 있습니다. 자세한 내용은 멀티 메인 설정 구성을 참고하세요.

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

필요에 따라 다양한 모드로 n8n을 실행할 수 있습니다. 큐 모드는 최고의 확장성을 제공합니다. 자세한 내용은 큐 모드를 참고하세요.

변수	타입	기본값	설명
`OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS`	Boolean	`false`	수동 실행을 메인 대신 워커에서 실행하려면 `true`로 설정합니다.
`QUEUE_BULL_PREFIX`	String	-	모든 큐 키에 사용할 접두사.
`QUEUE_BULL_REDIS_DB`	Number	`0`	사용할 Redis 데이터베이스.
`QUEUE_BULL_REDIS_HOST`	String	`localhost`	Redis 호스트.
`QUEUE_BULL_REDIS_PORT`	Number	`6379`	사용할 Redis 포트.
`QUEUE_BULL_REDIS_USERNAME`	String	-	Redis 사용자명(Redis 버전 6 이상 필요). Redis < 6 호환성을 위해서는 정의하지 마세요.
`QUEUE_BULL_REDIS_PASSWORD`	String	-	Redis 비밀번호.
`QUEUE_BULL_REDIS_TIMEOUT_THRESHOLD`	Number	`10000`	Redis 타임아웃 임계값(ms).
`QUEUE_BULL_REDIS_CLUSTER_NODES`	String	-	Redis 클라이언트가 초기 연결할 `host:port` 형식의 Redis 클러스터 노드 목록(쉼표로 구분). 큐 모드(`EXECUTIONS_MODE = queue`)로 실행 중이고 이 변수를 설정하면 Redis 클라이언트 대신 Redis 클러스터 클라이언트가 생성되며, n8n은 `QUEUE_BULL_REDIS_HOST`와 `QUEUE_BULL_REDIS_PORT`를 무시합니다.
`QUEUE_BULL_REDIS_TLS`	Boolean	`false`	Redis 연결에서 TLS 활성화.
`QUEUE_BULL_REDIS_DUALSTACK`	Boolean	`false`	Redis 연결에서 듀얼 스택(IPv4 및 IPv6) 지원 활성화.
`QUEUE_WORKER_TIMEOUT` (deprecated)	Number	`30`	더 이상 사용되지 않습니다. 대신 `N8N_GRACEFUL_SHUTDOWN_TIMEOUT`을 사용하세요. 워커 프로세스 종료 시 실행 중인 실행이 완료될 때까지 n8n이 대기하는 시간(초).
`QUEUE_HEALTH_CHECK_ACTIVE`	Boolean	`false`	상태 확인을 활성화(true) 또는 비활성화(false)할지 여부.
`QUEUE_HEALTH_CHECK_PORT`	Number	5678	상태 확인을 제공할 포트. 기본 포트를 사용하는 워커 서버 시작 시 포트 충돌 오류가 발생하면 변경하세요.
`QUEUE_WORKER_LOCK_DURATION`	Number	`60000`	워커가 메시지를 처리하는 임대 기간(ms).
`QUEUE_WORKER_LOCK_RENEW_TIME`	Number	`10000`	워커가 임대 시간을 갱신하는 주기(ms).
`QUEUE_WORKER_STALLED_INTERVAL`	Number	`30000`	워커가 중단된 작업을 확인하는 주기(0이면 확인하지 않음).
`QUEUE_WORKER_MAX_STALLED_COUNT`	Number	`1`	중단된 작업이 재처리될 최대 횟수.

멀티 메인 설정#

자세한 내용은 멀티 메인 설정 구성을 참고하세요.

변수	타입	기본값	설명
`N8N_MULTI_MAIN_SETUP_ENABLED`	Boolean	`false`	큐 모드에서 멀티 메인 설정 활성화 여부(라이선스 필요).
`N8N_MULTI_MAIN_SETUP_KEY_TTL`	Number	`10`	멀티 메인 설정에서 리더 키의 유효 시간(초).
`N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL`	Number	`3`	멀티 메인 설정에서 리더 확인 간격(초).

큐 모드 환경 변수

원문 보기

번역일: 2026-03-12

요약

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

필요에 따라 다양한 모드로 n8n을 실행할 수 있습니다. 큐 모드는 최고의 확장성을 제공합니다. 자세한 내용은 큐 모드를 참고하세요.

변수	타입	기본값	설명
`OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS`	Boolean	`false`	수동 실행을 메인 대신 워커에서 실행하려면 `true`로 설정합니다.
`QUEUE_BULL_PREFIX`	String	-	모든 큐 키에 사용할 접두사.
`QUEUE_BULL_REDIS_DB`	Number	`0`	사용할 Redis 데이터베이스.
`QUEUE_BULL_REDIS_HOST`	String	`localhost`	Redis 호스트.
`QUEUE_BULL_REDIS_PORT`	Number	`6379`	사용할 Redis 포트.
`QUEUE_BULL_REDIS_USERNAME`	String	-	Redis 사용자명(Redis 버전 6 이상 필요). Redis < 6 호환성을 위해서는 정의하지 마세요.
`QUEUE_BULL_REDIS_PASSWORD`	String	-	Redis 비밀번호.
`QUEUE_BULL_REDIS_TIMEOUT_THRESHOLD`	Number	`10000`	Redis 타임아웃 임계값(ms).
`QUEUE_BULL_REDIS_CLUSTER_NODES`	String	-	Redis 클라이언트가 초기 연결할 `host:port` 형식의 Redis 클러스터 노드 목록(쉼표로 구분). 큐 모드(`EXECUTIONS_MODE = queue`)로 실행 중이고 이 변수를 설정하면 Redis 클라이언트 대신 Redis 클러스터 클라이언트가 생성되며, n8n은 `QUEUE_BULL_REDIS_HOST`와 `QUEUE_BULL_REDIS_PORT`를 무시합니다.
`QUEUE_BULL_REDIS_TLS`	Boolean	`false`	Redis 연결에서 TLS 활성화.
`QUEUE_BULL_REDIS_DUALSTACK`	Boolean	`false`	Redis 연결에서 듀얼 스택(IPv4 및 IPv6) 지원 활성화.
`QUEUE_WORKER_TIMEOUT` (deprecated)	Number	`30`	더 이상 사용되지 않습니다. 대신 `N8N_GRACEFUL_SHUTDOWN_TIMEOUT`을 사용하세요. 워커 프로세스 종료 시 실행 중인 실행이 완료될 때까지 n8n이 대기하는 시간(초).
`QUEUE_HEALTH_CHECK_ACTIVE`	Boolean	`false`	상태 확인을 활성화(true) 또는 비활성화(false)할지 여부.
`QUEUE_HEALTH_CHECK_PORT`	Number	5678	상태 확인을 제공할 포트. 기본 포트를 사용하는 워커 서버 시작 시 포트 충돌 오류가 발생하면 변경하세요.
`QUEUE_WORKER_LOCK_DURATION`	Number	`60000`	워커가 메시지를 처리하는 임대 기간(ms).
`QUEUE_WORKER_LOCK_RENEW_TIME`	Number	`10000`	워커가 임대 시간을 갱신하는 주기(ms).
`QUEUE_WORKER_STALLED_INTERVAL`	Number	`30000`	워커가 중단된 작업을 확인하는 주기(0이면 확인하지 않음).
`QUEUE_WORKER_MAX_STALLED_COUNT`	Number	`1`	중단된 작업이 재처리될 최대 횟수.

멀티 메인 설정#

자세한 내용은 멀티 메인 설정 구성을 참고하세요.

변수	타입	기본값	설명
`N8N_MULTI_MAIN_SETUP_ENABLED`	Boolean	`false`	큐 모드에서 멀티 메인 설정 활성화 여부(라이선스 필요).
`N8N_MULTI_MAIN_SETUP_KEY_TTL`	Number	`10`	멀티 메인 설정에서 리더 키의 유효 시간(초).
`N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL`	Number	`3`	멀티 메인 설정에서 리더 확인 간격(초).