节点环境变量

基于文件的配置

您可以在单个变量后添加 _FILE 以在单独的文件中提供其配置。有关更多详细信息，请参阅在单独文件中保存敏感数据。

本页面列出了在 n8n 中管理节点的环境变量配置选项，包括指定要加载或排除的节点、在代码节点中导入内置或外部模块，以及启用社区节点。

变量	类型	默认值	描述
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 注册表 URL（需要许可证）。
N8N_CUSTOM_EXTENSIONS	String	-	指定包含自定义节点的目录路径。
N8N_PYTHON_ENABLED	Boolean	true	是否在代码节点上启用 Python 执行。
N8N_UNVERIFIED_PACKAGES_ENABLED	Boolean	true	当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时，此变量控制是否启用从 NPM 注册表安装和使用未验证的社区节点 (true) 或不启用 (false)。
N8N_VERIFIED_PACKAGES_ENABLED	Boolean	true	当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时，此变量控制是否在节点面板中显示验证的社区节点以供安装和使用 (true) 或隐藏它们 (false)。
NODE_FUNCTION_ALLOW_BUILTIN	String	-	允许用户在代码节点中导入特定的内置模块。使用 * 允许全部。n8n 默认禁用导入模块。
NODE_FUNCTION_ALLOW_EXTERNAL	String	-	允许用户在代码节点中导入特定的外部模块（来自 n8n/node_modules）。n8n 默认禁用导入模块。
NODES_ERROR_TRIGGER_TYPE	String	n8n-nodes-base.errorTrigger	指定要用作错误触发器的节点类型。
NODES_EXCLUDE	Array of strings	-	指定不要加载的节点。例如，要阻止在用户不可信任时可能存在安全风险的节点：NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]"
NODES_INCLUDE	Array of strings	-	指定要加载的节点。