队列模式环境变量#
基 于文件的配置
您可以在单个变量后添加 _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 | 多主节点设置中领导者检查的时间间隔（秒） |