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回滚升级#
安装你想回退到的旧版本即可。
如果升级过程中涉及数据库迁移:
- 查阅功能文档和发布说明,确认是否需要手动进行某些更改。
- 在当前版本上运行
n8n db:revert命令来回滚数据库。如果你需要回滚多个数据库迁移版本,则需要重复此过程。
Windows 故障排除#
如果你在 Windows 上运行 n8n 时遇到问题,请确保你的 Node.js 环境已正确配置。请参考微软的指南来在 Windows 上安装 NodeJS。