n8n 中文文档

表达式引擎环境变量

提示

File-based configuration 基于文件的配置

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

表达式 是 n8n 在运行时评估以动态设置节点参数的 JavaScript 片段。表达式引擎是运行该计算的组件。此页面列出了用于配置它的环境变量。

警告

避免使用 legacy 表达式引擎

legacy 引擎在没有隔离的情况下运行表达式,因此与沙箱化引擎相比,它对恶意表达式的防护较弱。n8n 计划在未来版本中弃用 legacy。为获得最强的安全保护:

  • 将 N8N_EXPRESSION_ENGINE 保持为后端默认值 vm。
  • 将 N8N_EXPRESSION_ENGINE_FRONTEND 设置为 quickjs。编辑器目前仍默认使用 legacy。

选择表达式引擎

n8n 会在两个位置计算表达式,每个位置都有自己的引擎设置:

  • 后端: 工作流运行时,n8n 服务器会计算表达式。N8N_EXPRESSION_ENGINE 用于选择此引擎。
  • 编辑器: 构建工作流时,浏览器会计算表达式,例如预览表达式的结果。N8N_EXPRESSION_ENGINE_FRONTEND 用于选择此引擎。

这两个设置彼此独立。

变量 类型 默认值 描述
N8N_EXPRESSION_ENGINE 枚举字符串:vm、quickjs、legacy vm 后端使用的表达式引擎。vm 在沙箱化的 V8 isolate 中运行表达式;quickjs 在编译为 WebAssembly 的 QuickJS 沙箱中运行表达式;legacy 在没有隔离的情况下运行表达式,n8n 计划弃用该引擎。从 n8n 2.35.0 起,默认值为 vm;更早的 n8n 版本默认使用 legacy。
N8N_EXPRESSION_ENGINE_FRONTEND 枚举字符串:legacy、quickjs legacy 编辑器在浏览器中使用的表达式引擎。quickjs 在编译为 WebAssembly 的 QuickJS 沙箱中运行表达式,并与页面其余部分隔离;legacy 在没有隔离的情况下运行表达式。n8n 强烈建议使用 quickjs。从 n8n 2.41.0 起可用。

配置沙箱化后端引擎

以下变量用于配置后端的 vm 和 quickjs 引擎。当 N8N_EXPRESSION_ENGINE 为 legacy 时,这些变量不会生效,也不会影响编辑器的引擎。

变量 类型 默认值 描述
N8N_EXPRESSION_ENGINE_POOL_SIZE 数字 1 池中保持预热的沙箱数量。
N8N_EXPRESSION_ENGINE_MAX_CODE_CACHE_SIZE 数字 1024 可缓存的已编译表达式最大数量。
N8N_EXPRESSION_ENGINE_TIMEOUT 数字 5000 每次表达式求值的执行超时时间(毫秒)。
N8N_EXPRESSION_ENGINE_MEMORY_LIMIT 数字 128 每个沙箱的内存上限(MiB)。
N8N_EXPRESSION_ENGINE_IDLE_TIMEOUT 数字 - 设置后,如果在指定秒数内没有活动,会将池缩减为零个预热沙箱。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。