큐 모드 환경 변수

파일 기반 구성

각 변수에 _FILE을 추가하면 별도의 파일에서 해당 변수를 설정할 수 있습니다. 자세한 내용은 민감한 데이터를 별도 파일에 저장하기 문서를 참고하세요.

n8n은 필요에 따라 다양한 모드로 실행할 수 있습니다. 큐 모드는 최고의 확장성을 제공합니다. 더 많은 정보는 Queue mode를 참조하세요.

변수	타입	기본값	설명
QUEUE_BULL_PREFIX	문자열	-	모든 큐 키에 사용할 접두사입니다.
QUEUE_BULL_REDIS_DB	숫자	0	사용되는 Redis 데이터베이스입니다.
QUEUE_BULL_REDIS_HOST	문자열	localhost	Redis 호스트입니다.
QUEUE_BULL_REDIS_PORT	숫자	6379	사용되는 Redis 포트입니다.
QUEUE_BULL_REDIS_USERNAME	문자열	-	Redis 사용자 이름입니다(버전 6 이상 필요). 호환성을 위해 Redis < 6 에 대해서는 정의하지 마세요.
QUEUE_BULL_REDIS_PASSWORD	문자열	-	Redis 비밀번호입니다.
QUEUE_BULL_REDIS_TIMEOUT_THRESHOLD	숫자	10000	Redis 타임아웃 임계값(밀리초 단위)입니다.
QUEUE_BULL_REDIS_CLUSTER_NODES	문자열	-	Redis 클러스터 노드를 host:port 형식으로 구분된 목록으로 기대합니다, Redis 클라이언트가 처음 연결할 수 있도록 합니다. 큐 모드(EXECUTIONS_MODE = queue)로 실행하는 경우 이 변수를 설정하면 Redis 클러스터 클라이언트를 생성하고 n8n은 QUEUE_BULL_REDIS_HOST 및 QUEUE_BULL_REDIS_PORT를 무시합니다.
QUEUE_BULL_REDIS_TLS	불리언	false	Redis 연결에서 TLS를 활성화합니다.
QUEUE_BULL_REDIS_DUALSTACK	불리언	false	Redis 연결에서 듀얼 스택 지원(IPv4 및 IPv6)을 활성화합니다.
QUEUE_WORKER_TIMEOUT (사용 중단)	숫자	30	사용 중단 N8N_GRACEFUL_SHUTDOWN_TIMEOUT를 대신 사용하세요. n8n이 종료 시 워커 프로세스를 종료하기 전에 실행 중인 실행을 위해 대기해야 할 시간(초)입니다.
QUEUE_HEALTH_CHECK_ACTIVE	불리언	false	헬스 체크를 활성화할지(true) 또는 비활성화할지(false) 여부입니다.
QUEUE_HEALTH_CHECK_PORT	숫자	-	헬스 체크를 제공할 포트입니다.
QUEUE_WORKER_LOCK_DURATION	숫자	30000	메시지를 처리하기 위한 워커의 임대 기간(밀리초)입니다.
QUEUE_WORKER_LOCK_RENEW_TIME	숫자	15000	워커가 임대 시간을 갱신해야 하는 빈도(밀리초)입니다.
QUEUE_WORKER_STALLED_INTERVAL	숫자	30000	워커가 정체된 작업을 확인하는 빈도(0을 사용하여 확인하지 않음)입니다.
QUEUE_WORKER_MAX_STALLED_COUNT	숫자	1	정체된 작업이 재처리될 최대 횟수입니다.

다중 메인 설정

다중 메인 설정 구성에 대한 자세한 내용은 Configuring multi-main setup을 참조하세요.

변수	타입	기본값	설명
N8N_MULTI_MAIN_SETUP_ENABLED	불리언	false	큐 모드의 다중 메인 설정을 활성화할지 여부(라이센스 필요)입니다.
N8N_MULTI_MAIN_SETUP_KEY_TTL	숫자	10	다중 메인 설정에서 리더 키의 생존 시간(초 단위)입니다.
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL	숫자	3	다중 메인 설정에서 리더 확인 간격(초 단위)입니다.