队列模式环境变量
提示
File-based configuration 基于文件的配置
您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。
您可以根据需要以不同的模式运行 n8n。队列模式提供了最好的可扩展性。有关更多信息,请参阅队列模式。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS |
Boolean | false |
如果希望手动执行在 worker 而不是主进程上运行,请设置为 true。 |
QUEUE_BULL_PREFIX |
String | - | 所有队列键使用的前缀。 |
N8N_REDIS_KEY_PREFIX |
String | n8n |
作业队列之外的 Redis 键和 pub/sub 频道的前缀,例如多主模式的领导者键、主实例与 worker 实例之间的消息、缓存和锁。如果两个或多个 n8n 部署共享同一个 Redis,请为每个部署设置不同的值,并在同一部署的每个主实例和 worker 上使用相同的值。在 n8n 2.3.0 之前,该前缀不适用于 pub/sub 频道,因此请为每个部署使用单独的 Redis。 |
N8N_CACHE_REDIS_KEY_PREFIX |
String | cache |
Redis 中缓存键的前缀。n8n 会将其添加在 N8N_REDIS_KEY_PREFIX 之后,例如 n8n:cache。 |
QUEUE_BULL_REDIS_DB |
Number | 0 |
使用的 Redis 数据库。 |
QUEUE_BULL_REDIS_HOST |
String | localhost |
Redis 主机。 |
QUEUE_BULL_REDIS_PORT |
Number | 6379 |
使用的 Redis 端口。 |
QUEUE_BULL_REDIS_USERNAME |
String | - | Redis 用户名(需要 Redis 6 或更高版本)。为兼容 Redis 6 以下版本,请勿定义此变量。 |
QUEUE_BULL_REDIS_PASSWORD |
String | - | Redis 密码。 |
QUEUE_BULL_REDIS_TIMEOUT_THRESHOLD |
Number | 10000 |
Redis 超时阈值(以毫秒为单位)。 |
QUEUE_BULL_REDIS_CLUSTER_NODES |
String | - | Redis 客户端初始连接时使用的 Redis Cluster 节点列表,以逗号分隔,格式为 host:port。在队列模式(EXECUTIONS_MODE = queue)下,设置此变量会创建 Redis Cluster 客户端而不是普通 Redis 客户端,并且 n8n 会忽略 QUEUE_BULL_REDIS_HOST 和 QUEUE_BULL_REDIS_PORT。 |
QUEUE_BULL_REDIS_TLS |
Boolean | false |
是否为 Redis 连接启用 TLS。 |
QUEUE_BULL_REDIS_DUALSTACK |
Boolean | false |
是否为 Redis 连接启用双栈支持(IPv4 和 IPv6)。 |
QUEUE_WORKER_TIMEOUT(deprecated 已弃用) |
Number | 30 |
自 n8n 1.22.0 起已弃用。请改用 N8N_GRACEFUL_SHUTDOWN_TIMEOUT。关闭时,在退出 worker 进程前,n8n 等待正在运行的执行完成的时间(秒)。 |
QUEUE_HEALTH_CHECK_ACTIVE |
Boolean | false |
是否启用(true)或禁用(false)健康检查。 |
QUEUE_HEALTH_CHECK_PORT |
Number | 5678 |
提供健康检查服务的端口。如果使用默认端口启动 worker 服务器时发生端口冲突,请更改此值。 |
QUEUE_WORKER_LOCK_DURATION |
Number | 60000 |
worker 处理一条消息的租约时长(以毫秒为单位)。 |
QUEUE_WORKER_LOCK_RENEW_TIME |
Number | 10000 |
worker 续订租约的频率(以毫秒为单位)。 |
QUEUE_WORKER_STALLED_INTERVAL |
Number | 30000 |
worker 检查停滞作业的频率(设置为 0 表示从不检查)。 |
QUEUE_WORKER_MAX_STALLED_COUNT(deprecated 已弃用) |
Number | 1 |
已弃用。 自 n8n 2.0 起已移除,设置此变量不会产生任何效果。有关迁移详情,请参阅移除 QUEUE_WORKER_MAX_STALLED_COUNT。 |
Webhook 响应
在队列模式下,worker 会通过队列消息将 Webhook 响应发回主实例。以下变量用于设置该消息的大小上限,以及当响应正文超过上限时,n8n 是否改为将其存入二进制数据存储,而不是让节点执行失败。详情请参阅大型 Webhook 响应。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX |
Number | 64 |
worker 通过队列消息发回主实例的响应大小上限(以 MiB 为单位)。Redis 会保留正在传输的响应的多个副本,因此每个传输中的响应应预留约为该值 1.5 倍的 Redis 内存。MCP Trigger 工作流返回的工具结果也受同一上限约束。 |
N8N_WEBHOOK_RESPONSE_RELAY_OFFLOAD_ENABLED |
Boolean | false |
是否由 worker 将超过 N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX 的响应正文存入二进制数据存储,让主实例可将其流式传输给客户端,而不是让节点执行失败。需要将 N8N_DEFAULT_BINARY_DATA_MODE 设为能够持久化数据的模式(filesystem、database、s3 或 azure),并确保所有实例都能读取该存储。仅在所有主实例和 Webhook 实例均运行 n8n 2.34.0 或更高版本后,才在 worker 上设置此变量。 |
多主设置
有关详细信息,请参阅配置多主设置。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_MULTI_MAIN_SETUP_ENABLED |
Boolean | false |
是否为队列模式启用多主设置(需要许可证)。 |
N8N_MULTI_MAIN_SETUP_KEY_TTL |
Number | 10 |
多主设置中领导者密钥的生存时间(以秒为单位)。 |
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL |
Number | 3 |
多主设置中领导者检查的间隔(以秒为单位)。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。