任务运行器环境变量#
基于文件的配置
您可以为单个变量添加 _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_INSECURE_MODE | 布尔值 | false | 是否禁用任务运行器中的所有安全措施，以兼容依赖不安全 JS 功能的模块。不推荐在生产环境中使用 |
N8N_RUNNERS_TASK_REQUEST_TIMEOUT | 数字 | 20 | 任务请求在超时前可等待运行器可用的时长（秒）。这可以防止在没有可用运行器时工作流无限期挂起。必须大于 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 | 任务运行器一次可执行的并发任务数量 |
任务运行器环境变量（所有语言）#
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
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 | 字符串 | - | 允许用户在代码节点中导入特定的内置模块。使用 * 允许所有模块。n8n 默认禁用模块导入 |
NODE_FUNCTION_ALLOW_EXTERNAL | 字符串 | - | 允许用户在代码节点中导入特定的外部模块（来自 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）#
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_RUNNERS_STDLIB_ALLOW | 字符串 | - | 可在代码节点中使用的 Python 标准库模块（包括其子模块）。使用 * 允许所有标准库模块。n8n 默认禁用所有 Python 标准库导入 |
N8N_RUNNERS_EXTERNAL_ALLOW | 字符串 | - | 允许在代码节点中使用的第三方 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 访问运行器的环境。出于安全原因，默认阻止环境变量访问 |