InfoGrab DocsInfoGrab Docs

큐 모드 환경 변수

요약

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 필요에 따라 n8n을 여러 모드로 실행할 수 있습니다. 큐 모드에서는 worker가 큐 메시지 안에 웹훅 응답을 담아 메인 인스턴스로 다시 보냅니다. 자세한 내용은 멀티 메인 설정 구성을 참고하세요.

참고

이 섹션의 상세 내용은 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 정체된 작업이 재처리되는 최대 횟수입니다.

웹훅 응답#

큐 모드에서는 worker가 큐 메시지 안에 웹훅 응답을 담아 메인 인스턴스로 다시 보냅니다. 이 변수들은 해당 메시지의 크기 한도와, 더 큰 응답 본문을 노드 실패 대신 바이너리 데이터 저장소에 저장할지 여부를 설정합니다. 자세한 내용은 대용량 웹훅 응답을 참고하세요.

변수 유형 기본값 설명
N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX Number 64 worker가 큐 메시지 안에 담아 메인 인스턴스로 다시 보내는 응답의 최대 크기(MiB)입니다. Redis는 전송 중인 응답의 여러 사본을 보관하므로, 전송 중인 응답 하나당 Redis 메모리를 이 값의 약 1.5배로 예산을 잡으세요. 동일한 제한이 MCP Trigger 워크플로가 반환하는 도구 결과에도 적용됩니다.
N8N_WEBHOOK_RESPONSE_RELAY_OFFLOAD_ENABLED Boolean false N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX를 초과하는 응답 본문을 worker가 노드 실패 대신 바이너리 데이터 저장소에 저장하여 메인 인스턴스가 이를 클라이언트로 스트리밍할 수 있도록 할지 여부입니다. 저장 방식(filesystem, database, s3, azure 중 하나)의 N8N_DEFAULT_BINARY_DATA_MODE와 모든 인스턴스가 읽을 수 있는 저장소가 필요합니다. 모든 메인 및 웹훅 인스턴스가 n8n 2.34.0 이상을 실행한 이후에만 worker에 이 설정을 적용하세요.

멀티 메인 설정#

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

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

큐 모드 환경 변수

n8n v2.34
원문 보기

요약

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 필요에 따라 n8n을 여러 모드로 실행할 수 있습니다. 큐 모드에서는 worker가 큐 메시지 안에 웹훅 응답을 담아 메인 인스턴스로 다시 보냅니다. 자세한 내용은 멀티 메인 설정 구성을 참고하세요.

참고

이 섹션의 상세 내용은 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 정체된 작업이 재처리되는 최대 횟수입니다.

웹훅 응답#

큐 모드에서는 worker가 큐 메시지 안에 웹훅 응답을 담아 메인 인스턴스로 다시 보냅니다. 이 변수들은 해당 메시지의 크기 한도와, 더 큰 응답 본문을 노드 실패 대신 바이너리 데이터 저장소에 저장할지 여부를 설정합니다. 자세한 내용은 대용량 웹훅 응답을 참고하세요.

변수 유형 기본값 설명
N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX Number 64 worker가 큐 메시지 안에 담아 메인 인스턴스로 다시 보내는 응답의 최대 크기(MiB)입니다. Redis는 전송 중인 응답의 여러 사본을 보관하므로, 전송 중인 응답 하나당 Redis 메모리를 이 값의 약 1.5배로 예산을 잡으세요. 동일한 제한이 MCP Trigger 워크플로가 반환하는 도구 결과에도 적용됩니다.
N8N_WEBHOOK_RESPONSE_RELAY_OFFLOAD_ENABLED Boolean false N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX를 초과하는 응답 본문을 worker가 노드 실패 대신 바이너리 데이터 저장소에 저장하여 메인 인스턴스가 이를 클라이언트로 스트리밍할 수 있도록 할지 여부입니다. 저장 방식(filesystem, database, s3, azure 중 하나)의 N8N_DEFAULT_BINARY_DATA_MODE와 모든 인스턴스가 읽을 수 있는 저장소가 필요합니다. 모든 메인 및 웹훅 인스턴스가 n8n 2.34.0 이상을 실행한 이후에만 worker에 이 설정을 적용하세요.

멀티 메인 설정#

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

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