队列模式环境变量(Queue mode environment variables)

File-based configuration

You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.

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

🌐 You can run n8n in different modes depending on your needs. Queue mode provides the best scalability. Refer to Queue mode for more information.

变量	类型	默认值	描述
OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS	布尔值	false	如果你希望手动执行在工作线程上运行而不是在主线程上运行，则设置为 true。
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 集群节点列表，格式为 host:port，用于 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	数字	5678	提供健康检查的端口。如果在使用默认端口启动工作服务器时遇到端口冲突错误，请更改此端口。
QUEUE_WORKER_LOCK_DURATION	数字	60000	工作线程处理消息的租约周期为多长时间（以毫秒为单位）。
QUEUE_WORKER_LOCK_RENEW_TIME	数字	10000	工作者应该以多频繁（毫秒为单位）更新租约时间。
QUEUE_WORKER_STALLED_INTERVAL	数字	30000	工作线程应多久检查一次停滞的工作（从不检查请使用 0）。
QUEUE_WORKER_MAX_STALLED_COUNT	数字	1	停滞作业将被重新处理的最大次数。

多主设置(Multi-main setup)

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

🌐 Refer to Configuring multi-main setup for details.

变量	类型	默认值	描述
N8N_MULTI_MAIN_SETUP_ENABLED	布尔值	false	是否启用队列模式的多主设置（需要授权）。
N8N_MULTI_MAIN_SETUP_KEY_TTL	数字	10	多主设置中主控键的生存时间（秒）。
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL	数字	3	多主设置中主控检查的间隔时间（秒）。