큐 모드 환경 변수
n8n v2.29이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 필요에 따라 n8n을 여러 모드로 실행할 수 있습니다. 종료 시 worker 프로세스를 종료하기 전에 실행 중인 실행 작업을 n8n이 얼마나(초) 기다려야 하는지를 지정합니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
필요에 따라 n8n을 여러 모드로 실행할 수 있습니다. 큐 모드는 최상의 확장성을 제공합니다. 자세한 내용은 큐 모드를 참고하세요.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS |
Boolean | false |
수동 실행이 main이 아닌 worker에서 실행되도록 하려면 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 |
더 이상 사용되지 않음(Deprecated) 대신 N8N_GRACEFUL_SHUTDOWN_TIMEOUT을 사용하세요. |
종료 시 worker 프로세스를 종료하기 전에 실행 중인 실행 작업을 n8n이 얼마나(초) 기다려야 하는지를 지정합니다. |
| QUEUE_HEALTH_CHECK_ACTIVE | Boolean | false | 상태 확인을 활성화(true)할지 비활성화(false)할지 여부입니다. |
| QUEUE_HEALTH_CHECK_PORT | Number | 5678 | 상태 확인을 제공할 포트입니다. worker 서버를 기본 포트로 시작할 때 포트 충돌 오류가 발생하면 이 값을 변경하세요. |
| QUEUE_WORKER_LOCK_DURATION | Number | 60000 | worker가 메시지 작업을 수행할 임대 기간(ms)입니다. |
| QUEUE_WORKER_LOCK_RENEW_TIME | Number | 10000 | worker가 임대 시간을 갱신하는 빈도(ms)입니다. |
| QUEUE_WORKER_STALLED_INTERVAL | Number | 30000 | worker가 정체된(stalled) 작업을 확인하는 빈도입니다(0이면 확인하지 않음). |
| QUEUE_WORKER_MAX_STALLED_COUNT | Number | 1 | 정체된 작업이 재처리되는 최대 횟수입니다. |
멀티 메인 설정#
자세한 내용은 멀티 메인 설정 구성을 참고하세요.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_MULTI_MAIN_SETUP_ENABLED |
Boolean | false |
큐 모드에서 멀티 메인 설정을 활성화할지 여부입니다(라이선스 필요). |
N8N_MULTI_MAIN_SETUP_KEY_TTL |
Number | 10 |
멀티 메인 설정에서 리더 키의 TTL(초)입니다. |
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL |
Number | 3 |
멀티 메인 설정에서 리더 확인 간격(초)입니다. |