任务运行器环境变量

基于文件的配置

您可以在单个变量后添加 _FILE 以在单独的文件中提供其配置。有关更多详细信息，请参阅在单独文件中保存敏感数据。

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

n8n 实例环境变量

变量	类型	默认值	描述
N8N_RUNNERS_ENABLED	Boolean	false	是否启用任务运行器。
N8N_RUNNERS_MODE	Enum string: internal, external	internal	如何启动和运行任务运行器。internal 表示 n8n 将任务运行器作为子进程启动。external 表示外部编排器将启动任务运行器。
N8N_RUNNERS_AUTH_TOKEN	String	Random 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	60	任务在终止和运行器重启之前可以完成的时间（秒）。必须大于 0。
N8N_RUNNERS_HEARTBEAT_INTERVAL	Number	30	运行器必须向代理发送心跳的频率（秒），否则任务终止且运行器重启。必须大于 0。
N8N_RUNNERS_INSECURE_MODE	Boolean	false	是否禁用任务运行器中的所有安全措施，以兼容依赖不安全 JS 功能的模块。不建议在生产环境中使用。

任务运行器启动器环境变量

变量	类型	默认值	描述
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_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）

Variable	Type	Default	Description
NODE_FUNCTION_ALLOW_BUILTIN	String	-	允许用户在代码节点中导入特定的内置模块。使用 * 允许所有。n8n 默认禁用模块导入。
NODE_FUNCTION_ALLOW_EXTERNAL	String	-	允许用户在代码节点中导入特定的外部模块（来自 n8n/node_modules）。n8n 默认禁用模块导入。
N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION	Boolean	false	是否允许外部库的原型变异。设置为 true 以允许依赖运行时原型变异的模块（例如，puppeteer），但会降低安全性。
GENERIC_TIMEZONE	*	America/New_York	与为 n8n 实例配置的相同默认时区。
NODE_OPTIONS	String	-	Node.js 的选项。
N8N_RUNNERS_MAX_OLD_SPACE_SIZE	String		用于任务运行器的 --max-old-space-size 选项（以 MB 为单位）。默认情况下，Node.js 将根据可用内存设置此值。

任务运行器环境变量（Python）

Variable	Type	Default	Description
N8N_RUNNERS_STDLIB_ALLOW	String	-	允许用户在代码节点中导入特定的 Python 标准库模块。使用 * 允许所有。n8n 默认禁用所有 Python 标准库导入。
N8N_RUNNERS_EXTERNAL_ALLOW	String	-	允许用户在代码节点中导入特定的第三方 Python 模块（如果在 n8nio/runners 镜像中可用）。使用 * 允许所有。n8n 默认禁用所有第三方 Python 模块。
N8N_RUNNERS_BUILTINS_DENY	String	eval,exec,compile,open,input,breakpoint,getattr,object,type,vars,setattr,delattr,hasattr,dir,memoryview,__build_class__	不允许的不安全 Python 内置函数列表。设置为空字符串以允许所有。