任务运行器环境变量

¥Task runner environment variables

File-based configuration

You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.

任务运行器 执行由 代码节点 定义的代码。

¥Task runners execute code defined by the Code node.

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	是否禁用任务运行器中的所有安全措施，以兼容依赖不安全 JavaScript 功能的模块。不建议在生产环境中使用。
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	字符串	*	允许用户在代码节点中导入特定的外部模块（来自 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	字符串	*	可在代码节点中使用的 Python 标准库模块及其子模块。使用 * 允许所有标准库模块。n8n 默认禁用所有 Python 标准库导入。
N8N_RUNNERS_EXTERNAL_ALLOW	字符串	*	允许在代码节点中使用的第三方 Python 模块及其子模块。使用 * 允许所有外部模块。n8n 默认禁用所有第三方 Python 模块。第三方 Python 模块在 n8nio/runners 镜像中必须是 included。
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 访问运行器的环境。出于安全考虑，默认情况下会阻止对环境变量的访问。