跳到主要内容

节点环境变量#

基于文件的配置

您可以在个别变量后添加 _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布尔值trueN8N_COMMUNITY_PACKAGES_ENABLED为true时,控制是否启用从NPM注册表安装使用未验证社区节点(true)
N8N_VERIFIED_PACKAGES_ENABLED布尔值trueN8N_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字符串数组-指定要加载的节点