节点环境变量
提示
File-based configuration 基于文件的配置
您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。
本页列出了用于管理 n8n 中的节点[^1] 的环境变量配置选项,包括指定要加载或排除的节点、在代码节点中导入内置或外部模块、启用社区节点以及配置特定于节点的限制。
节点及社区节点设置
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_COMMUNITY_PACKAGES_AUTH_TOKEN |
String | - | 私有 npm registry 的认证 token。与 N8N_COMMUNITY_PACKAGES_REGISTRY 配合使用,用于在从私有 registry 安装社区节点时对请求进行认证。 |
N8N_COMMUNITY_PACKAGES_ENABLED |
Boolean | true |
启用(true)或禁用(false)安装并加载社区节点的能力。如果设为 false,无论其各自设置如何,已验证和未验证的社区包都不会可用。 |
N8N_COMMUNITY_PACKAGES_PREVENT_LOADING |
Boolean | false |
在实例启动时阻止(true)或允许(false)加载已安装的社区节点。如果某个有问题的节点导致实例无法启动,可使用此选项。 |
N8N_COMMUNITY_PACKAGES_REGISTRY |
String | https://registry.npmjs.org |
用于拉取社区包的 NPM registry URL(需要许可证)。 |
N8N_CUSTOM_EXTENSIONS |
String | - | 指定包含自定义节点的目录路径。 |
N8N_PYTHON_ENABLED |
Boolean | true |
是否在 Code 节点中启用 Python 执行。 |
N8N_UNVERIFIED_PACKAGES_ENABLED |
Boolean | true |
当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时,该变量控制是否允许从 NPM registry 安装并使用未验证社区节点(true)或禁止(false)。 |
N8N_VERIFIED_PACKAGES_ENABLED |
Boolean | true |
当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时,该变量控制是否在节点面板中显示已验证社区节点以供安装和使用(true),或将其隐藏(false)。 |
NODE_FUNCTION_ALLOW_BUILTIN |
String | - | 允许用户在 Code 节点中导入指定的内置模块。使用 * 表示允许全部。n8n 默认禁用模块导入。 |
NODE_FUNCTION_ALLOW_EXTERNAL |
String | - | 允许用户在 Code 节点中导入指定的外部模块(来自 n8n/node_modules)。n8n 默认禁用模块导入。 |
NODES_ERROR_TRIGGER_TYPE |
String | n8n-nodes-base.errorTrigger |
指定要用作 Error Trigger 的节点类型。 |
NODES_EXCLUDE |
Array of strings | [\"n8n-nodes-base.executeCommand\", \"n8n-nodes-base.localFileTrigger\"] |
指定不加载哪些节点。例如,如果用户不可信,可通过该变量阻止可能带来安全风险的节点:NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]"。如需启用所有节点,请设置 NODES_EXCLUDE: "[]"。 |
NODES_INCLUDE |
Array of strings | - | 指定要加载哪些节点。 |
NODES_MERGE_SQL_SANDBOX_MEMORY_LIMIT_MB |
Number | 64 |
Merge 节点 SQL sandbox 的内存限制(MB)。如果使用 Combine by SQL 处理大型数据集时失败,且实例有足够可用内存,请提高此值。 |
压缩节点设置
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES |
Number | 268435456 |
解压后输出的最大总大小(字节)。默认值为 256 MiB。 |
N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES |
Number | 1000 |
ZIP 归档中允许的最大条目数。 |
管理已安装的社区包
提示
功能可用性
从 n8n 2.21.0 起,可以通过环境变量管理已安装的社区包。
从环境变量中预先配置安装的社区包。有关 *_MANAGED_BY_ENV 模式,请参阅使用环境变量管理实例设置。
| 变量 | 类型 | 默认 | 描述 |
|---|---|---|---|
N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV |
布尔 | false |
设置为 true 以从环境变量管理已安装的社区包。当 true 时,n8n 在每次启动时根据 N8N_COMMUNITY_PACKAGES 协调已安装的软件包,安装丢失的软件包,更正版本和 uninstalling any currently-installed packages that aren't in the list 卸载列表中没有的所有当前安装的软件包。 Community nodes 社区节点 设置页面变为只读:启用此功能后,您无法从 UI 安装、更新或卸载软件包。 |
N8N_COMMUNITY_PACKAGES |
JSON 字符串 | - | 要安装的社区包的 JSON 数组。每个条目都是一个对象,具有 name(必需)以及可选的 version 和 checksum 字段。您还可以将版本嵌入名称中,如 <package-name>@<version>。有关每个字段的完整参考,请参阅环境变量安装。 |
[^1]:在 n8n 中,节点是您用来创建工作流的单独组件。节点定义工作流何时运行,允许您获取、发送和处理数据,可以定义流控制逻辑,并与外部服务连接。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。