Skip to content

任务运行器环境变量#

/// 注意 | 基于文件的配置 您可以在个别变量后添加 _FILE 后缀，通过单独的文件提供配置。详情请参阅将敏感数据保存在单独文件中。 ///

任务运行器执行由代码节点定义的代码。

n8n 实例环境变量#

变量名 类型 默认值 描述
N8N_RUNNERS_ENABLED 布尔值 false 是否启用任务运行器。
N8N_RUNNERS_MODE 枚举字符串: internal, external internal 如何启动和运行任务运行器。internal 表示 n8n 将作为子进程启动任务运行器。external 表示由外部编排器启动任务运行器。
N8N_RUNNERS_AUTH_TOKEN 字符串 随机字符串 任务运行器用于向 n8n 认证的共享密钥。在 external 模式下必需。
N8N_RUNNERS_BROKER_PORT 数字 5679 任务代理监听任务运行器连接的端口。
N8N_RUNNERS_BROKER_LISTEN_ADDRESS 字符串 127.0.0.1 任务代理监听的地址。
N8N_RUNNERS_MAX_PAYLOAD 数字 1 073 741 824 任务代理与任务运行器之间通信的最大有效载荷大小（字节）。
N8N_RUNNERS_MAX_OLD_SPACE_SIZE 字符串 用于任务运行器的 --max-old-space-size 选项（单位 MB）。默认情况下，Node.js 会根据可用内存设置此值。
N8N_RUNNERS_MAX_CONCURRENCY 数字 5 任务运行器可同时执行的并发任务数量。
N8N_RUNNERS_TASK_TIMEOUT 数字 60 任务在终止前允许运行的最长时间（秒），超时后运行器会重启。必须大于 0。
N8N_RUNNERS_HEARTBEAT_INTERVAL 数字 30 运行器向代理发送心跳的间隔时间（秒），超时未发送则任务终止且运行器重启。必须大于 0。

任务运行器启动器环境变量#

变量名 类型 默认值 描述
N8N_RUNNERS_LAUNCHER_LOG_LEVEL 枚举字符串: debug, info, warn, error info 要显示的日志消息级别。
N8N_RUNNERS_AUTH_TOKEN 字符串 - 用于向 n8n 认证的共享密钥。
N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT 数字 15 在关闭空闲运行器前等待的秒数。
N8N_RUNNERS_TASK_BROKER_URI 字符串 http://127.0.0.1:5679 任务代理服务器(n8n实例)的URI地址。
N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT 数字 5680 启动器健康检查服务器的端口号。
N8N_RUNNERS_MAX_PAYLOAD 数字 1 073 741 824 任务代理与任务运行器之间通信的最大有效载荷大小(字节)。
N8N_RUNNERS_MAX_CONCURRENCY 数字 5 一个任务运行器可同时执行的最大并发任务数。
NODE_OPTIONS 字符串 - Node.js 的配置选项。

任务运行器环境变量#

变量名 类型 默认值 描述
N8N_RUNNERS_GRANT_TOKEN 字符串 随机字符串 运行器用于与任务代理进行身份验证的令牌。此令牌由启动器自动提供。
N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT 数字 15 在关闭空闲运行器前等待的秒数。
N8N_RUNNERS_TASK_BROKER_URI 字符串 http://127.0.0.1:5679 任务代理服务器（n8n实例）的URI地址。
N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT 数字 5680 启动器健康检查服务器的端口号。
N8N_RUNNERS_MAX_PAYLOAD 数字 1 073 741 824 任务代理与任务运行器之间通信的最大有效载荷大小（字节）。
N8N_RUNNERS_MAX_CONCURRENCY 数字 5 单个任务运行器可同时执行的最大并发任务数。
NODE_FUNCTION_ALLOW_BUILTIN 字符串 - 允许用户在代码节点中导入特定的内置模块。使用*表示允许所有。n8n默认禁用模块导入。
NODE_FUNCTION_ALLOW_EXTERNAL 字符串 - 允许用户在代码节点中导入特定的外部模块（来自n8n/node_modules）。n8n默认禁用模块导入。
N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION 布尔值 false 是否允许外部库进行原型变异。设置为true可允许依赖运行时原型变异的模块（例如puppeteer），但会降低安全性。
GENERIC_TIMEZONE * America/New_York 与n8n实例配置相同的默认时区。