队列模式环境变量

¥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 客户端需要以逗号分隔的 Redis 集群节点列表（格式为 host:port）进行初始连接。如果以队列模式 (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	是否启用健康检查（启用）或禁用（禁用）。
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	多主节点设置中领导者检查的间隔（秒）。