n8n 中文文档

任务运行器环境变量

提示

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 工作流库 找现成的中文工作流。