队列模式环境变量

基于文件的配置

您可以在单个变量后添加 _FILE 以在单独的文件中提供其配置。有关更多详细信息，请参阅在单独文件中保存敏感数据。

您可以根据需要在不同模式下运行 n8n。队列模式提供最佳的可扩展性。有关更多信息，请参考队列模式。

变量	类型	默认值	描述
QUEUE_BULL_PREFIX	String	-	用于所有队列密钥的前缀。
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	-	期望以 host:port 格式的 Redis 集群节点的逗号分隔列表，供 Redis 客户端初始连接。如果在队列模式下运行（EXECUTIONS_MODE = queue），设置此变量将创建 Redis 集群客户端而不是 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 (已弃用)	Number	30	已弃用 请改用 N8N_GRACEFUL_SHUTDOWN_TIMEOUT。 在关闭时退出工作进程之前，n8n 应等待运行执行多长时间（秒）。
QUEUE_HEALTH_CHECK_ACTIVE	Boolean	false	是否启用健康检查（true）或禁用（false）。
QUEUE_HEALTH_CHECK_PORT	Number	-	提供健康检查的端口。
QUEUE_WORKER_LOCK_DURATION	Number	30000	工作器处理消息的租期时长（以毫秒为单位）。
QUEUE_WORKER_LOCK_RENEW_TIME	Number	15000	工作器应多久（以毫秒为单位）续约租期时间。
QUEUE_WORKER_STALLED_INTERVAL	Number	30000	工作器应多久检查一次停滞的作业（使用 0 表示从不）。
QUEUE_WORKER_MAX_STALLED_COUNT	Number	1	停滞作业被重新处理的最大次数。

多主设置

有关详细信息，请参考配置多主设置。

变量	类型	默认值	描述
N8N_MULTI_MAIN_SETUP_ENABLED	Boolean	false	是否为队列模式启用多主设置（需要许可证）。
N8N_MULTI_MAIN_SETUP_KEY_TTL	Number	10	多主设置中领导者密钥的生存时间（以秒为单位）。
N8N_MULTI_MAIN_SETUP_CHECK_INTERVAL	Number	3	多主设置中领导者检查的间隔（以秒为单位）。