部署托管/Configuration/Environment_variables
任务运行器环境变量#
基于文件的配置
你可以在单个变量后添加 _FILE，以在单独的文件中提供其配置。更多详情请参见将敏感数据保存在独立文件中。
任务运行器 用于执行由 代码节点（Code node） 定义的代码。
n8n 实例环境变量#
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_RUNNERS_ENABLED | 布尔值 | false | 是否启用任务运行器。 |
N8N_RUNNERS_MODE | 枚举字符串：internal, external | internal | 如何启动和运行任务运行器。internal 表示 n8n 将作为子进程启动一个任务运行器；external 表示由外部编排器（orchestrator）来启动任务运行器。 |
N8N_RUNNERS_AUTH_TOKEN | 字符串 | 随机字符串 | 任务运行器用于向 n8n 认证的共享密钥。使用 external 模式时必须设置。 |
N8N_RUNNERS_BROKER_PORT | 数字 | 5679 | 任务代理（broker）监听任务运行器连接的端口。 |
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_INSECURE_MODE | 布尔值 | false | 是否禁用任务运行器中的所有安全措施，以便兼容依赖不安全 JS 特性的模块。不建议在生产环境中使用。 |
任务运行器启动器环境变量#
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | 单个任务运行器可同时执行的任务数量。 |
任务运行器环境变量（所有语言）#
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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）#
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
NODE_FUNCTION_ALLOW_BUILTIN | 字符串 | - | 允许用户在代码节点中导入特定的 Node.js 内置模块。使用 * 表示允许所有模块。n8n 默认禁止导入任何模块。 |
NODE_FUNCTION_ALLOW_EXTERNAL | 字符串 | - | 允许用户在代码节点中导入特定的外部模块（来自 n8n/node_modules）。n8n 默认禁止导入任何外部模块。 |
N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION | 布尔值 | false | 是否允许对外部库进行原型修改（prototype mutation）。设为 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）#
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_RUNNERS_STDLIB_ALLOW | 字符串 | - | 允许在代码节点中使用的 Python 标准库模块（包括其子模块）。使用 * 表示允许所有标准库模块。n8n 默认禁止所有 Python 标准库的导入。 |
N8N_RUNNERS_EXTERNAL_ALLOW | 字符串 | - | 允许在代码节点中使用的第三方 Python 模块（包括其子模块）。使用 * 表示允许所有外部模块。n8n 默认禁止所有第三方 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 内置函数。设为空字符串表示允许所有内置函数。 |