部署托管/Configuration/Environment_variables
节点环境变量#
基于文件的配置
您可以在个别变量后添加 _FILE,以在单独的文件中提供其配置。更多详情请参见将敏感数据保存在独立文件中。
本页面列出了用于管理 n8n 中 节点 的环境变量配置选项,包括指定要加载或排除的节点、在代码节点中导入内置或外部模块,以及启用社区节点。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_COMMUNITY_PACKAGES_ENABLED | 布尔值 | true | 启用(true)或禁用(false)安装和加载社区节点的功能。如果设置为 false,则无论各个包的设置如何,已验证和未验证的社区包均不可用。 |
N8N_COMMUNITY_PACKAGES_PREVENT_LOADING | 布尔值 | false | 在实例启动时阻止(true)或允许(false)加载已安装的社区节点。当某个故障节点导致实例无法启动时可使用此选项。 |
N8N_COMMUNITY_PACKAGES_REGISTRY | 字符串 | https://registry.npmjs.org | 拉取社区包的 NPM 注册表 URL(需要许可证)。 |
N8N_CUSTOM_EXTENSIONS | 字符串 | - | 指定包含自定义节点的目录路径。 |
N8N_PYTHON_ENABLED | 布尔值 | true | 是否在代码节点中启用 Python 执行。 |
N8N_UNVERIFIED_PACKAGES_ENABLED | 布尔值 | true | 当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时,该变量控制是否允许从 NPM 注册表安装和使用未验证的社区节点(true)或不允许(false)。 |
N8N_VERIFIED_PACKAGES_ENABLED | 布尔值 | true | 当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时,该变量控制是否在节点面板中显示已验证的社区节点供安装和使用(true),或将其隐藏(false)。 |
NODE_FUNCTION_ALLOW_BUILTIN | 字符串 | - | 允许用户在代码节点中导入特定的内置模块(built-in modules)。使用 * 表示允许所有模块。默认情况下,n8n 禁止导入模块。 |
NODE_FUNCTION_ALLOW_EXTERNAL | 字符串 | - | 允许用户在代码节点中导入特定的外部模块(来自 n8n/node_modules)。默认情况下,n8n 禁止导入模块。 |
NODES_ERROR_TRIGGER_TYPE | 字符串 | n8n-nodes-base.errorTrigger | 指定用作错误触发器(Error Trigger)的节点类型。 |
NODES_EXCLUDE | 字符串数组 | - | 指定不加载哪些节点。例如,若用户不可信,可阻止存在安全风险的节点:NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]" |
NODES_INCLUDE | 字符串数组 | - | 指定要加载的节点。 |