节点环境变量

基于文件的配置

您可以在单个变量后添加 _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 registry URL（需要许可证）。
N8N_CUSTOM_EXTENSIONS	String	-	指定包含自定义节点的目录路径。
N8N_PYTHON_ENABLED	Boolean	true	是否在 Code 节点中启用 Python 执行。
N8N_UNVERIFIED_PACKAGES_ENABLED	Boolean	true	当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时，该变量用于控制是否允许从 NPM registry 安装并使用未验证的社区节点（true）或禁止（false）。
N8N_VERIFIED_PACKAGES_ENABLED	Boolean	true	当 N8N_COMMUNITY_PACKAGES_ENABLED 为 true 时，该变量用于控制是否在节点面板中显示可安装和使用的已验证社区节点（true），或隐藏它们（false）。
NODE_FUNCTION_ALLOW_BUILTIN	String	-	允许用户在 Code 节点中导入指定的内置模块。使用 * 允许全部。n8n 默认禁用模块导入。
NODE_FUNCTION_ALLOW_EXTERNAL	String	-	允许用户在 Code 节点中导入指定的外部模块（来自 n8n/node_modules）。n8n 默认禁用模块导入。
NODES_ERROR_TRIGGER_TYPE	String	n8n-nodes-base.errorTrigger	指定用作 Error Trigger 的节点类型。
NODES_EXCLUDE	Array of strings	[\"n8n-nodes-base.executeCommand\", \"n8n-nodes-base.localFileTrigger\"]	指定不加载的节点。例如，当用户不可信时，可通过该变量阻止可能存在安全风险的节点：NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]"。要启用所有节点，请设置 NODES_EXCLUDE: "[]"。
NODES_INCLUDE	Array of strings	-	指定要加载的节点。