队列模式环境变量#

基于文件的配置

您可以在单个变量后添加 _FILE 后缀，通过独立文件提供配置。更多细节请参阅将敏感数据保存在独立文件中。

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

变量名	类型	默认值	描述
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 客户端初始连接。若在队列模式下运行（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	停滞作业最大重新处理次数

多主节点设置#

详细信息请参阅配置多主节点设置。

变量名	类型	默认值	描述
N8N_MULTI_MAIN_SETUP_ENABLED	布尔值	false	是否启用队列模式的多主节点设置（需要许可证）
N8N_MULTI_MAIN_SETUP_KEY_TTL	数字	10	多主节点设置中领导者键的存活时间（秒）
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL	数字	3	多主节点设置中领导者检查的时间间隔（秒）