节点环境变量#
基于文件的配置
您可以在个别变量后添加 _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注册表地址(需许可证) |
N8N_CUSTOM_EXTENSIONS | 字符串 | - | 指定自定义节点目录路径 |
N8N_PYTHON_ENABLED | 布尔值 | true | 是否在代码节点中启用Python执行功能 |
N8N_UNVERIFIED_PACKAGES_ENABLED | 布尔值 | true | 当N8N_COMMUNITY_PACKAGES_ENABLED为true时,控制是否启用从NPM注册表安装使用未验证社区节点(true) |
N8N_VERIFIED_PACKAGES_ENABLED | 布尔值 | true | 当N8N_COMMUNITY_PACKAGES_ENABLED为true时,控制是否在节点面板显示已验证社区节点供安装使用(true) |
NODE_FUNCTION_ALLOW_BUILTIN | 字符串 | - | 允许用户在代码节点导入特定内置模块。使用*允许全部。n8n默认禁用模块导入 |
NODE_FUNCTION_ALLOW_EXTERNAL | 字符串 | - | 允许用户在代码节点导入特定外部模块(来自n8n/node_modules)。n8n默认禁用模块导入 |
NODES_ERROR_TRIGGER_TYPE | 字符串 | n8n-nodes-base.errorTrigger | 指定用作错误触发器的节点类型 |
NODES_EXCLUDE | 字符串数组 | - | 指定不加载的节点。例如阻止存在安全风险的节点:NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]" |
NODES_INCLUDE | 字符串数组 | - | 指定要加载的节点 |