节点环境变量#

基于文件的配置

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

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

节点与社区节点设置#

变量	类型	默认值	说明
`N8N_COMMUNITY_PACKAGES_AUTH_TOKEN`	String	-	私有 npm registry 的认证 token。与 `N8N_COMMUNITY_PACKAGES_REGISTRY` 配合使用，用于在从私有 registry 安装社区节点时对请求进行认证。
`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	-	指定要加载哪些节点。

Compression 节点设置#

变量	类型	默认值	说明
`N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES`	Number	`2147483648`	解压后输出的最大总大小（字节）。默认值为 2 GiB。
`N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES`	Number	`5000`	ZIP 归档中允许的最大条目数。

管理已安装的社区包#

自 n8n v2.21.0 起可用

通过环境变量预配置已安装的社区包。关于 *_MANAGED_BY_ENV 模式，请参阅使用环境变量管理实例设置。

变量	类型	默认值	说明
`N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV`	Boolean	`false`	设为 `true` 后，可通过环境变量管理已安装的社区包。启用后，n8n 会在每次启动时根据 `N8N_COMMUNITY_PACKAGES` 对已安装包进行对账：安装缺失的包、修正版本，并且卸载所有未出现在列表中的当前已安装包。Community nodes 社区节点设置页会变为只读，启用期间无法在 UI 中安装、更新或卸载包。
`N8N_COMMUNITY_PACKAGES`	JSON string	-	要安装的社区包 JSON 数组。每一项都是一个对象，包含 `name`（必填）以及可选的 `version` 和 `checksum` 字段。你也可以把版本直接写进名称中，格式为 `<package-name>@<version>`。每个字段的完整说明请参阅环境变量安装。