节点环境变量

信息

通过文件配置

可以为单个变量添加 _FILE 后缀，通过单独的文件提供配置。更多信息请参阅将敏感数据保存在单独的文件中。

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

节点和社区节点设置

变量	类型	默认值	说明
N8N_COMMUNITY_PACKAGES_AUTH_TOKEN	String	-	私有 npm 注册表的身份验证令牌。与 N8N_COMMUNITY_PACKAGES_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 注册表 URL，需要许可证。
N8N_CUSTOM_EXTENSIONS	String	-	指定包含自定义节点的目录路径。
N8N_PYTHON_ENABLED	Boolean	true	是否在 Code 节点中启用 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	-	允许用户在 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	字符串数组	[\"n8n-nodes-base.executeCommand\", \"n8n-nodes-base.localFileTrigger\"]	指定不加载的节点。例如，用户不可信时，可阻止具有安全风险的节点：NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]"。要启用所有节点，指定 NODES_EXCLUDE: "[]"。
NODES_INCLUDE	字符串数组	-	指定要加载的节点。
NODES_MERGE_SQL_SANDBOX_MEMORY_LIMIT_MB	Number	64	Merge 节点 SQL 沙箱的内存上限，单位为 MB。Combine by SQL 处理大数据集失败，且实例有足够内存时，可以提高此值。

Compression 节点设置

变量	类型	默认值	说明
N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES	Number	268435456	解压后输出的总大小上限，单位为字节。默认为 256 MiB。
N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES	Number	1000	ZIP 压缩包允许的最大条目数量。

管理已安装的社区节点包

信息

功能可用范围

自 n8n 2.21.0 起，支持通过环境变量管理已安装的社区节点包。

通过环境变量预配置已安装的社区节点包。有关 *_MANAGED_BY_ENV 机制，请参阅通过环境变量管理实例设置。

变量	类型	默认值	说明
N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV	Boolean	false	设为 true，通过环境变量管理已安装的社区节点包。当值为 true 时，n8n 会在每次启动时根据 N8N_COMMUNITY_PACKAGES 校正已安装的包：安装缺失的包、纠正版本，并卸载当前已安装但不在列表中的所有包。**Community nodes（社区节点）**设置页会变为只读，启用期间无法通过界面安装、更新或卸载包。
N8N_COMMUNITY_PACKAGES	JSON 字符串	-	要安装的社区节点包的 JSON 数组。每项是一个对象，包含必需的 name 字段，以及可选的 version 和 checksum 字段。也可以通过 <package-name>@<version> 形式，将版本写在名称中。完整字段参考请参阅通过环境变量安装。

相关资源

• 环境变量

Footnotes

1. 在 n8n 中，节点是组成工作流的独立组件。节点定义工作流何时运行，获取、发送和处理数据，控制流程逻辑，并连接外部服务。 ↩