节点环境变量

基于文件的配置

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

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

变量	类型	默认值	描述
NODES_INCLUDE	字符串数组	-	指定要加载的节点。
NODES_EXCLUDE	字符串数组	-	指定不要加载的节点。例如，阻止可能成为安全风险的节点（如果用户不可信）：NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"n8n-nodes-base.readWriteFile\"]"
NODE_FUNCTION_ALLOW_BUILTIN	String	-	允许用户在代码节点中导入特定的内置模块。使用 * 允许全部。n8n 默认禁用导入模块。
NODE_FUNCTION_ALLOW_EXTERNAL	String	-	允许用户在代码节点中导入特定的外部模块（来自 n8n/node_modules）。n8n 默认禁用导入模块。
NODES_ERROR_TRIGGER_TYPE	String	n8n-nodes-base.errorTrigger	指定用作错误触发器的节点类型。
N8N_CUSTOM_EXTENSIONS	String	-	指定包含自定义节点的目录路径。
N8N_COMMUNITY_PACKAGES_ENABLED	Boolean	true	启用（true）或禁用（false）安装和加载社区节点的功能。如果设置为 false，无论其个别设置如何，经过验证和未经验证的社区包都将不可用。
N8N_COMMUNITY_PACKAGES_REGISTRY	String	https://registry.npmjs.org	用于拉取社区包的 NPM 注册表 URL（需要许可证）。
N8N_VERIFIED_PACKAGES_ENABLED	Boolean	true	当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时，此变量控制是否在节点面板中显示经过验证的社区节点以供安装和使用（true）或隐藏它们（false）。
N8N_UNVERIFIED_PACKAGES_ENABLED	Boolean	true	当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时，此变量控制是否启用从 NPM 注册表安装和使用未经验证的社区节点（true）或不启用（false）。
N8N_COMMUNITY_PACKAGES_PREVENT_LOADING	Boolean	false	阻止（true）或允许（false）在实例启动时加载已安装的社区节点。如果有故障节点阻止实例启动，请使用此选项。