N8N中文教程
部署托管/Installation

npm#

使用 npm 是在本地机器上快速开始运行 n8n 的一种方式。你需要先安装 Node.js。n8n 要求 Node.js 版本介于 20.19 和 24.x 之间(含)。 最新版与下一个版本 n8n 大多每周发布一个新的次要版本。latest 版本适用于生产环境,而 next 是最新的发布版本。你应该将 next 视为测试版(beta):它可能不稳定。如需报告问题,请使用 论坛。 当前 latest:1.115.2 当前 next:1.116.1

使用 npx 尝试 n8n#

你可以使用 npx 在不安装的情况下尝试 n8n。 在终端中运行:

npx n8n

此命令将下载启动 n8n 所需的所有内容。之后,你可以通过访问 http://localhost:5678 来使用 n8n 并开始构建工作流。

使用 npm 全局安装#

要全局安装 n8n,请使用 npm:

npm install -g n8n

若要安装或更新到特定版本的 n8n,可使用 @ 语法指定版本号。例如:

npm install -g n8n@1.115.2

安装 next 版本:

npm install -g n8n@next

安装完成后,运行以下命令启动 n8n:

n8n
# 或者
n8n start

下一步#

尝试使用 快速入门指南(Quickstarts) 来体验 n8n。

更新#

要将你的 n8n 实例更新到 latest 版本,请运行:

npm install -g n8n

安装 next 版本:

npm install -g n8n@next

使用隧道的 n8n#

危险 仅用于本地开发和测试。在生产环境中使用是不安全的。 为了使外部服务(如 GitHub)的触发节点能够使用 Webhook,n8n 必须可以从公网访问。n8n 内置了一个 隧道服务(tunnel service),可以将来自 n8n 服务器的请求重定向到你本地的 n8n 实例。 通过运行以下命令并添加 --tunnel 参数来启动 n8n:

n8n start --tunnel

回滚升级#

安装你想回退到的旧版本即可。

如果升级过程中涉及数据库迁移:

  1. 查阅功能文档和发布说明,确认是否需要手动进行某些更改。
  2. 在当前版本上运行 n8n db:revert 命令来回滚数据库。如果你需要回滚多个数据库迁移版本,则需要重复此过程。

Windows 故障排除#

如果你在 Windows 上运行 n8n 时遇到问题,请确保你的 Node.js 环境已正确配置。请参考微软的指南来在 Windows 上安装 NodeJS。