在 n8n 应用中安装来自 npm 的社区节点

仅适用于自托管 n8n 实例的所有者

只有自托管 n8n 实例的所有者才能从 npm 安装和管理社区节点。实例所有者是指设置并管理用户管理的人员。

管理员账户也可以卸载任何社区节点（无论是否经过验证）。这有助于他们移除可能影响实例健康和功能的问题节点。

安装社区节点

要通过 npm 安装社区节点：

1. 进入 设置 > 社区节点。
2. 选择 安装。
3. 查找要安装的节点：
   1. 选择 浏览。n8n 将跳转至 npm 搜索结果页面，显示所有标记有 n8n-community-node-package 关键字的 npm 包。
   2. 浏览结果列表。您可以筛选结果或添加更多关键词。
   3. 找到所需包后，记录包名称。如需安装特定版本，请同时记录版本号。
   4. 返回 n8n 界面。
4. 输入 npm 包名称（如需特定版本则包含版本号）。例如，假设有一个用于访问天气 API "Storms" 的社区节点，其包名为 n8n-node-storms，包含三个主要版本：
   • 要安装最新版本的 n8n-node-weather 包：在 输入 npm 包名 处填写 n8n-nodes-storms。
   • 要安装 2.3 版本：在 输入 npm 包名 处填写 n8n-node-storms@2.3。
5. 同意使用社区节点的风险声明：勾选 我理解从公共源安装未经验证代码的风险。
6. 选择 安装。n8n 将安装该节点并返回 设置 中的 社区节点 列表。

黑名单中的节点

n8n 维护了一个社区节点黑名单，禁止安装这些节点。更多信息请参阅 n8n 社区节点黑名单。

卸载社区节点

要卸载社区节点：

1. 进入 设置 > 社区节点。
2. 在目标节点上选择 选项 。
3. 选择 卸载包。
4. 在确认弹窗中选择 卸载包。

升级社区节点

版本中的破坏性变更

节点开发者可能会在他们的节点新版本中引入破坏性变更。破坏性变更是指会破坏原有功能的更新。根据节点开发者选择的版本控制方式，升级到包含破坏性变更的版本可能会导致所有使用该节点的工作流无法运行。升级节点时请务必谨慎。如果发现升级导致问题，您可以降级节点版本。

升级到最新版本

您可以通过 设置 > 社区节点 中的节点列表将社区节点升级到最新版本。

当社区节点有新版本可用时，n8n 会在节点上显示 更新 按钮。点击该按钮即可升级到最新版本。

升级到特定版本

要升级到特定版本（非最新版本），请先卸载该节点，然后重新安装时指定目标版本。更多指导请参考安装说明。

降级社区节点

如果某个特定版本的社区节点存在问题，您可能需要回滚到之前的版本。

为此，请先卸载社区节点，然后重新安装时指定目标节点版本。更多指导请参考安装说明。