Skip to content

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

¥Install community nodes from npm in the n8n app

Only for instance owners of self-hosted n8n instances

仅自托管 n8n 实例的所有者可以通过 npm 安装和管理社区节点。实例所有者是设置和管理用户管理的人员。

¥Only the n8n instance owner of a self-hosted n8n instance can install and manage community nodes from npm. The instance owner is the person who sets up and manages user management.

管理员账户还可以卸载任何社区节点，无论是否经过验证。这有助于移除可能影响实例运行状况和功能的异常节点。

¥Admin accounts can also uninstall any community node, verified or unverified. This helps them remove problematic nodes that may affect the instance's health and functionality.

安装社区节点#

¥Install a community node

要从 npm 安装社区节点：

¥To install a community node from npm:

  1. 前往“设置”>“社区节点”。

¥Go to Settings > Community Nodes. 2. 选择“安装”。

¥Select Install. 3. 找到要安装的节点：

¥Find the node you want to install: 1. 选择“浏览”。n8n 会将你带到 npm 搜索结果页面，显示所有带有关键字 n8n-community-node-package 标签的 npm 包。

1
  ¥Select **Browse**. n8n takes you to an npm search results page, showing all npm packages tagged with the keyword `n8n-community-node-package`.

  1. 浏览结果列表。你可以筛选结果或添加更多关键字。

    ¥Browse the list of results. You can filter the results or add more keywords. 3. 找到所需的软件包后，请记下软件包名称。如果你想安装特定版本，请记下版本号。

    ¥Once you find the package you want, make a note of the package name. If you want to install a specific version, make a note of the version number as well. 4. 返回 n8n。

    ¥Return to n8n. 4. 输入 npm 包名称，如果需要，请输入版本号。例如，考虑一个用于访问名为 "风暴。" 的天气 API 的社区节点。该节点的包名为 n8n-node-storms，共有三个主要版本。

¥Enter the npm package name, and version number if required. For example, consider a community node designed to access a weather API called "Storms." The package name is n8n-node-storms, and it has three major versions.

  • 安装名为 n8n-node-weather 的软件包的最新版本：在“输入 npm 包名称”中输入 n8n-nodes-storms。

    ¥To install the latest version of a package called n8n-node-weather: enter n8n-nodes-storms in Enter npm package name.

  • 安装 2.3 版本：在“输入 npm 包名称”中输入 n8n-node-storms@2.3。

    ¥To install version 2.3: enter n8n-node-storms@2.3 in Enter npm package name. 5. 同意使用社区节点的 risks：选择“我了解从公共来源安装未经验证代码的风险”。

¥Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source. 6. 选择“安装”。n8n 安装节点后，会将其返回到“设置”中的“社区节点”列表。

¥Select Install. n8n installs the node, and returns to the Community Nodes list in Settings.

Nodes on the blocklist

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

¥n8n maintains a blocklist of community nodes that it prevents you from installing. Refer to n8n community node blocklist for more information.

卸载社区节点#

¥Uninstall a community node

要卸载社区节点：

¥To uninstall a community node:

  1. 前往“设置”>“社区节点”。

¥Go to Settings > Community nodes. 2. 在要安装的节点上，选择“选项”Three dots options menu。

¥On the node you want to install, select Options {.off-glb}. 3. 选择“卸载程序包”。

¥Select Uninstall package. 4. 在确认对话框中选择“卸载软件包”。

¥Select Uninstall Package in the confirmation modal.

升级社区节点#

¥Upgrade a community node

Breaking changes in versions

节点开发者可能会在其节点的新版本中引入重大更改。破坏性变更是指会破坏先前功能的更新。取决于节点版本控制方法。如果节点开发者选择升级到包含重大变更的版本，则可能会导致所有使用该节点的流程崩溃。升级节点时请务必小心。如果你发现升级导致问题，可以执行 downgrade。

¥Node developers may introduce breaking changes in new versions of their nodes. A breaking change is an update that breaks previous functionality. Depending on the node versioning approach that a node developer chooses, upgrading to a version with a breaking change could cause all workflows using the node to break. Be careful when upgrading your nodes. If you find that an upgrade causes issues, you can downgrade.

升级到最新版本#

¥Upgrade to the latest version

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

¥You can upgrade community nodes to the latest version from the node list in Settings > community nodes.

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

¥When a new version of a community node is available, n8n displays an Update button on the node. Click the button to upgrade to the latest version.

升级到特定版本#

¥Upgrade to a specific version

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

¥To upgrade to a specific version (a version other than the latest), uninstall the node, then reinstall it, making sure to specify the target version. Follow the Installation instructions for more guidance.

降级社区节点#

¥Downgrade a community node

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

¥If there is a problem with a particular version of a community node, you may want to roll back to a previous version.

为此，请卸载社区节点，然后重新安装，并选择特定的节点版本。请遵循 安装 说明获取更多指导。

¥To do this, uninstall the community node, then reinstall it, targeting a specific node version. Follow the Installation instructions for more guidance.