队列模式环境变量(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.

| 变量 | 类型 | 默认值 | 描述 |

| :------- | :---- | :------- | :---------- |

| QUEUE_BULL_PREFIX | 字符串 | - | 用于所有队列键的前缀。 |

| QUEUE_BULL_REDIS_DB | 数字 | 0 | 使用的 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_WORKER_TIMEOUT（已弃用） | 数字 | 30 | 已弃用。请改用 N8N_GRACEFUL_SHUTDOWN_TIMEOUT。

n8n 在关闭工作进程时，应等待运行中的执行任务多长时间（秒）后退出。 |

| 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`	多主设置中主控检查的间隔时间（秒）。