任务运行器环境变量(Task runner environment variables)#
基于文件的配置
与主 n8n 镜像不同，你不能在任务执行器镜像中使用基于文件的机密配置。这意味着添加了 _FILE 后缀的变量将无法被识别。
n8n 实例环境变量(n8n instance environment variables)#
| 变量 | 类型 | 默认值 | 描述 |
| :------- | :---- | :------- | :---------- |
| 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 | 数字 | 300 | 在运行器停止任务并重新启动之前，任务可以运行的最长时间（以秒为单位）。此值必须大于 0。 |
| N8N_RUNNERS_HEARTBEAT_INTERVAL | 数字 | 30 | 运行器必须向代理发送心跳的间隔（以秒为单位）。如果运行器未能及时发送心跳，任务将停止并且运行器会重新启动。该值必须大于0。 |
| N8N_RUNNERS_INSECURE_MODE | 布尔值 | false | 是否禁用任务运行器中的所有安全措施，以兼容依赖不安全 JS 功能的模块。不建议在生产环境中使用。 |
| N8N_RUNNERS_TASK_REQUEST_TIMEOUT | 数字 | 20 | 任务请求可以等待执行者可用的最长时间（以秒为单位），超过该时间将超时。这可以防止在没有可用执行者时工作流无限期挂起。必须大于 0。|
任务运行器启动器环境变量(Task runner launcher environment variables)#
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
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 |
任务运行器一次可以执行的并发任务数。 |
任务运行器环境变量（所有语言）(Task runner environment variables (all languages))#
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
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 |
任务运行器一次可以执行的并发任务数量。 |
任务运行器环境变量（JavaScript）(Task runner environment variables (JavaScript))#
| 变量 | 类型 | 默认值 | 描述 |
| :------- | :---- | :------- | :---------- |
| NODE_FUNCTION_ALLOW_BUILTIN | 字符串 | - | 允许用户在代码节点中导入特定的内置模块。使用 * 允许导入所有模块。n8n 默认禁用模块导入。 |
| NODE_FUNCTION_ALLOW_EXTERNAL | 字符串 | - | 允许用户在 Code 节点中导入特定的外部模块（来自 n8n/node_modules）。n8n 默认禁用模块导入。 |
| N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION | 布尔值 | false | 是否允许对外部库进行原型变更。设置为 true 可以允许依赖运行时原型变更的模块（例如 puppeteer），但代价是降低安全性。 |
| GENERIC_TIMEZONE | * | America/New_York | 与 n8n 实例配置的相同默认时区 相同。 |
| NODE_OPTIONS | 字符串 | - | Node.js 的 选项。 |
| N8N_RUNNERS_MAX_OLD_SPACE_SIZE | 字符串 | | 用于任务运行器的 --max-old-space-size 选项（以 MB 为单位）。默认情况下，Node.js 会根据可用内存设置此值。 |
任务运行器环境变量（Python）(Task runner environment variables (Python))#
| 变量 | 类型 | 默认值 | 描述 |
| :------- | :---- | :------- | :---------- |
| N8N_RUNNERS_STDLIB_ALLOW | 字符串 | - | 可以在 Code 节点中使用的 Python 标准库模块，包括它们的子模块。使用 * 允许使用所有标准库模块。默认情况下，n8n 禁用所有 Python 标准库导入。 |
| N8N_RUNNERS_EXTERNAL_ALLOW | 字符串 | - | 允许在 Code 节点中使用的第三方 Python 模块，包括其子模块。使用 * 可允许所有外部模块。n8n 默认禁用所有第三方 Python 模块。第三方 Python 模块必须包含在 n8nio/runners 镜像中。|
| N8N_RUNNERS_BUILTINS_DENY | 字符串 | eval,exec,compile,open,input,breakpoint,getattr,object,type,vars,setattr,delattr,hasattr,dir,memoryview,__build_class__,globals,locals | 你在代码节点中不能使用的 Python 内置函数。设置为空字符串以允许所有内置函数。 |
| N8N_BLOCK_RUNNER_ENV_ACCESS | 布尔值 | true | 是否阻止从 Python 代码任务中访问运行器的环境。设置为 false 可允许所有 Python 代码节点用户通过 os.environ 访问运行器的环境。出于安全原因，默认情况下环境变量访问被阻止。 |