Skip to content

在 n8n 应用中从 npm 安装社区节点#

Owner and Admin users only 仅限 Owner 与 Admin 用户

只有具有 Owner 或 Admin 角色的用户，才能在自托管 n8n 实例上从 npm 安装和管理社区节点。实例所有者是设置并管理用户管理的人员。

安装社区节点#

要从 npm 安装社区节点：

  1. 进入 Settings > Community Nodes。
  2. 选择 Install。
  3. 找到你想安装的节点：
    1. 选择 Browse。n8n 会带你进入 npm 搜索结果页，展示所有带有 n8n-community-node-package 关键词标签的 npm 包。
    2. 浏览结果列表。你可以筛选结果，或添加更多关键词。
    3. 找到目标包后，记下包名。如果你想安装特定版本，也请同时记下版本号。
    4. 返回 n8n。

  4. 输入 npm 包名，并可选择附上版本号或 dist-tag。例如，假设有一个用于访问天气 API 的社区节点叫做 "Storms"。它的包名是 n8n-node-storms，并且有三个主版本。

    • 要安装名为 n8n-node-storms 的包的最新版本：在 Enter npm package name 中输入 n8n-nodes-storms。
    • 要安装 2.3 版本：在 Enter npm package name 中输入 [email protected]。
    • 若要使用 beta 这类 dist-tag 安装：在 Enter npm package name 中输入 n8n-node-storms@beta。你可以使用包作者发布的任何 npm dist-tag，例如 beta、next 或 latest。

    dist-tag 只在安装时解析一次

    使用 dist-tag 安装包时，n8n 会在安装当下把该 tag 解析为当前版本。后续更新不会继续跟随该 dist-tag。例如，如果安装 n8n-node-storms@beta，且 beta 指向版本 2.0.0-beta.1，n8n 会安装这个具体版本。之后的更新会基于已安装的语义化版本进行比较，而不是基于 beta tag。

    5. 同意使用社区节点的风险：选择我理解从公共源安装未验证代码的风险。 6. 选择安装。n8n 安装节点，并返回到设置中的社区节点列表。

黑名单上的节点

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

卸载社区节点#

要卸载社区节点：

  1. 转到设置 > 社区节点。
  2. 在要卸载的节点上，选择选项 三点选项菜单。
  3. 选择卸载包。
  4. 在确认模态框中选择卸载包。

升级社区节点#

版本中的破坏性更改

节点开发者可能在其节点的新版本中引入破坏性更改。破坏性更改是破坏先前功能的更新。根据节点开发者选择的节点版本控制方法，升级到带有破坏性更改的版本可能导致使用该节点的所有工作流中断。升级节点时要小心。如果发现升级导致问题，您可以降级。

升级到最新版本#

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

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

升级到特定版本#

要升级到特定版本（非最新版本），请卸载节点，然后重新安装，确保指定目标版本。有关更多指导，请遵循安装说明。

降级社区节点#

如果社区节点的特定版本存在问题，您可能希望回滚到以前的版本。

要执行此操作，请卸载社区节点，然后重新安装，指定特定的节点版本。有关更多指导，请遵循安装说明。