npm 安装

npm 是在本地计算机上快速启动 n8n 的方式之一。你必须已安装 Node.js。n8n 需要 Node.js 版本在 20.19 到 24.x 之间（含端点版本）。

稳定版与 Beta 版

n8n 几乎每周发布一个新的次版本。stable 版本适用于生产环境，beta 是最新发布版本，可能不够稳定。如需反馈问题，请使用社区论坛。

当前 stable 版本：2.10.2　当前 beta 版本：2.11.1

使用 npx 试用 n8n

你可以不安装直接使用 npx 试用 n8n。

在终端中运行：

npx n8n

该命令将下载启动 n8n 所需的所有内容。完成后，在浏览器中打开 http://localhost:5678 即可访问 n8n 并开始构建工作流。

全局安装 n8n（使用 npm）

使用 npm 全局安装 n8n：

npm install n8n -g

使用 @ 语法指定版本来安装或更新到特定版本的 n8n。例如：

npm install -g n8n@1.81.0

安装 next 版本：

npm install -g n8n@next

安装完成后，通过以下命令启动 n8n：

n8n
# 或
n8n start

后续步骤

使用快速入门指南体验 n8n 的功能。

更新

将 n8n 实例更新到 latest 版本：

npm update -g n8n

安装 next 版本：

npm install -g n8n@next

使用 n8n 隧道（Tunnel）

危险

仅用于本地开发和测试，不适合在生产环境中使用。

开发工具

隧道功能是本地开发的便捷工具，其底层实现可能随 n8n 版本更新而变化。

要使用 GitHub 等外部服务的触发节点的 Webhook 功能，n8n 必须能够从互联网访问。n8n 通过 cloudflared 提供隧道服务，将网络请求重定向到你本地的 n8n 实例。隧道功能需要安装 Docker。

需要安装 Docker

隧道使用 cloudflared，后者作为 Docker 容器运行。即使你通过 npm 运行 n8n，也需要在你的机器上安装 Docker。

对于 npm 安装方式，请使用仅服务方式：将 cloudflared 作为独立服务启动，然后在本地运行 n8n：

# 终端 1：启动 cloudflared 隧道服务
pnpm --filter n8n-containers services --services cloudflared

# 终端 2：本地启动 n8n
pnpm dev

services 命令会启动 cloudflared，获取公共隧道 URL，并将带有 WEBHOOK_URL 和 N8N_PROXY_HOPS=1 的 .env 文件写入 packages/cli/bin/.env。n8n 在启动时会自动读取该 .env 文件。

完成后清理：

pnpm --filter n8n-containers services:clean

对于完整栈方式（n8n 和 cloudflared 都在容器中运行），请参阅 Docker 隧道配置。

回滚升级

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

如果升级涉及数据库迁移：

1. 查看功能文档和发行说明，了解是否需要进行手动变更。
2. 在当前版本上运行 n8n db:revert 以回滚数据库。如果需要撤回多个数据库迁移，则需要重复此操作。

Windows 故障排除

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