队列模式环境变量

/// 注意 | 基于文件的配置 您可以在个别变量后添加 _FILE 后缀，通过单独的文件提供配置。详情请参阅将敏感数据保存在单独文件中。 ///

您可以根据需求以不同模式运行 n8n。队列模式提供最佳的可扩展性。更多信息请参考队列模式。

变量名	类型	默认值	描述
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 用户名(需要 Redis 6 或更高版本)。为兼容 Redis < 6 版本请不要定义此变量
QUEUE_BULL_REDIS_PASSWORD	字符串	-	Redis 密码。
QUEUE_BULL_REDIS_TIMEOUT_THRESHOLD	数字	10000	Redis 超时阈值(毫秒)。
QUEUE_BULL_REDIS_CLUSTER_NODES	字符串	-	以逗号分隔的 Redis 集群节点列表，格式为 主机:端口，供 Redis 客户端初始连接。如果在队列模式下运行(EXECUTIONS_MODE = queue)，设置此变量将创建 Redis 集群客户端而非普通 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	停滞作业最多可被重新处理的次数。

多主节点设置

详情请参阅配置多主节点设置。

变量	类型	默认值	描述
N8N_MULTI_MAIN_SETUP_ENABLED	Boolean	false	是否启用队列模式的多主节点设置（需要许可证）。
N8N_MULTI_MAIN_SETUP_KEY_TTL	Number	10	多主节点设置中领导者密钥的生存时间（秒）。
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL	Number	3	多主节点设置中领导者检查的间隔时间（秒）。