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