任务运行器环境变量
提示
File-based configuration 基于文件的配置
与主 n8n 映像不同,您不能在任务运行器映像中使用基于文件的机密配置。这意味着带有 _FILE 后缀的变量不会被识别。
n8n实例环境变量
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_RUNNERS_ENABLED(已弃用) |
Boolean | false |
是否启用任务运行器。自 n8n 2.0 起弃用。 |
N8N_RUNNERS_MODE |
Enum string:internal(已弃用)、external |
internal |
如何启动和运行任务运行器。internal 表示 n8n 将任务运行器作为子进程启动。已弃用:内部模式将在未来版本中移除。external 表示由外部编排器启动任务运行器。请参阅外部模式。 |
N8N_RUNNERS_AUTH_TOKEN |
String | 随机字符串 | 任务运行器用于向 n8n 进行身份验证的共享密钥。使用 external 模式时必需。 |
N8N_RUNNERS_BROKER_PORT |
Number | 5679 |
任务代理监听任务运行器连接的端口。 |
N8N_RUNNERS_BROKER_LISTEN_ADDRESS |
String | 127.0.0.1 |
任务代理监听的地址。 |
N8N_RUNNERS_MAX_PAYLOAD |
Number | 1 073 741 824 |
任务代理与任务运行器之间通信的最大负载大小(字节)。 |
N8N_RUNNERS_MAX_OLD_SPACE_SIZE |
String | 任务运行器使用的 --max-old-space-size 选项(MB)。默认情况下,Node.js 会根据可用内存设置此值。 |
|
N8N_RUNNERS_MAX_CONCURRENCY |
Number | 5 |
任务运行器一次可并发执行的任务数。 |
N8N_RUNNERS_TASK_TIMEOUT |
Number | 300 |
任务在运行器停止并重启它之前可运行的最长时间(秒)。此值必须大于 0。 |
N8N_RUNNERS_HEARTBEAT_INTERVAL |
Number | 30 |
运行器必须向代理发送心跳的间隔(秒)。如果运行器未及时发送心跳,任务会停止,运行器会重启。此值必须大于 0。 |
N8N_RUNNERS_INSECURE_MODE |
Boolean | false |
是否禁用任务运行器中的所有安全措施,以兼容依赖不安全 JS 功能的模块。不建议在生产环境中使用。 |
N8N_RUNNERS_TASK_REQUEST_TIMEOUT |
Number | 60 |
任务请求在超时前可等待运行器可用的时间(秒)。这可防止没有可用运行器时工作流无限期挂起。必须大于 0。 |
任务运行器启动器环境变量
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_RUNNERS_LAUNCHER_LOG_LEVEL |
Enum string: debug, info, warn, error |
info |
显示哪些日志消息。 |
N8N_RUNNERS_AUTH_TOKEN |
String | - | 用于向 n8n 进行身份验证的共享密钥。 |
N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT |
Number | 15 |
关闭空闲运行器之前等待的秒数。 |
N8N_RUNNERS_TASK_BROKER_URI |
String | http://127.0.0.1:5679 |
任务代理服务器(n8n 实例)的 URI。 |
N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT |
Number | 5680 |
启动器健康检查服务器的端口。 |
N8N_RUNNERS_MAX_PAYLOAD |
Number | 1 073 741 824 |
任务代理和任务运行器之间通信的最大有效负载大小(字节)。 |
N8N_RUNNERS_MAX_CONCURRENCY |
Number | 5 |
任务运行器一次可以执行的并发任务数。 |
任务运行程序环境变量(所有语言)
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_RUNNERS_GRANT_TOKEN |
String | Random string | 运行器用于向任务代理进行身份验证的令牌。这由启动器自动提供。 |
N8N_RUNNERS_ID |
String | Random string | runner 用于向 task broker 标识自身的 ID。在 internal 模式下,n8n 会为启动的每个 runner 设置该值。在 external 模式下,除非需要在 broker 日志中使用稳定 ID,否则请留空:每个 runner 都必须使用唯一值;两个 runner 共用同一值时会不断互相驱逐。请在 runner 配置文件(/etc/n8n-task-runners.json)中为每种 runner 类型以 env-override 设置,而不要将其设置为容器环境变量。自 n8n 2.35.0 起可用。 |
N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT |
Number | 15 |
关闭空闲运行器之前等待的秒数。 |
N8N_RUNNERS_TASK_BROKER_URI |
String | http://127.0.0.1:5679 |
任务代理服务器(n8n 实例)的 URI。 |
N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT |
Number | 5680 |
启动器健康检查服务器的端口。 |
N8N_RUNNERS_MAX_PAYLOAD |
Number | 1 073 741 824 |
任务代理和任务运行器之间通信的最大有效负载大小(字节)。 |
N8N_RUNNERS_MAX_CONCURRENCY |
Number | 5 |
任务运行器一次可以执行的并发任务数。 |
任务运行程序环境变量 (JavaScript)
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
NODE_FUNCTION_ALLOW_BUILTIN |
字符串 | - | 允许用户在代码节点导入特定的内置模块。使用 * 允许所有。 n8n 默认禁用导入模块。在外部模式下,在 runners 配置文件 (/etc/n8n-task-runners.json) 中将其设置为 env-override,而不是容器环境变量。 |
NODE_FUNCTION_ALLOW_EXTERNAL |
字符串 | - | 允许用户在代码节点中导入特定的外部模块(来自n8n/node_modules)。 n8n 默认禁用导入模块。在外部模式下,在 runners 配置文件 (/etc/n8n-task-runners.json) 中将其设置为 env-override,而不是容器环境变量。 |
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 标准库模块,包括其子模块。使用 * 允许所有 stdlib 模块。 n8n 默认禁用所有 Python 标准库导入。在外部模式下,在 runners 配置文件 (/etc/n8n-task-runners.json) 中将其设置为 env-override,而不是容器环境变量。 |
N8N_RUNNERS_EXTERNAL_ALLOW |
字符串 | - | 允许在代码节点中使用的第三方 Python 模块,包括其子模块。使用 * 允许所有外部模块。n8n 默认禁用所有第三方 Python 模块。第三方 Python 模块必须包含在 n8nio/runners 映像中。在外部模式下,在 runners 配置文件(/etc/n8n-task-runners.json)中将其设置为 env-override,而不是容器环境变量。 |
N8N_RUNNERS_ALLOW_TRANSITIVE_IMPORTS |
布尔 | false |
是否允许 allowlist 中 package 自身代码发起的 import 跳过 import allowlist(包括 N8N_RUNNERS_EXTERNAL_ALLOW 和 N8N_RUNNERS_STDLIB_ALLOW)。设置为 true 后,allowlist 中的 package 可加载它导入的任何模块(传递依赖和 stdlib),无需逐个列出。这有助于内部 import 会拉取其他模块的 package(例如 pandas 导入 pytz,或 boto3 导入 dateutil)。你在 Code 节点中自己的 import 仍会按 allowlist 检查。启用此选项表示信任所有已安装 package 的 import 活动,而不仅是列出的 package:被攻陷的依赖可能拉取 allowlist 原本会阻止的模块,因此仅当 runner image 中安装的 package 可信时才启用。在外部模式下,请在 runners 配置文件 (/etc/n8n-task-runners.json) 中将其设置为 env-override,而不是容器环境变量。 |
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 访问运行器环境。出于安全原因,默认情况下会阻止环境变量访问。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。