npm#

npm 是在本地机器上快速开始使用 n8n 的方式。您必须已安装 Node.js。n8n 支持 Node.js 20.19 至 24.x 版本。

Stable 和 Beta 版本

n8n 通常每周发布一个新的次要版本。stable 版本用于生产环境。beta 是最新版本。beta 版本可能不稳定。如需报告问题，请使用论坛。

Current stable: 2.12.3 Current beta: 2.13.1

使用 npx 试用 n8n#

您可以使用 npx 试用 n8n 而无需安装它。

从终端运行：

npx n8n

此命令将下载启动 n8n 所需的一切。然后您可以通过打开 http://localhost:5678 来访问 n8n 并开始构建工作流。

使用 npm 全局安装#

要全局安装 n8n，请使用 npm：

npm install n8n -g

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

npm install -g [email protected]

要安装 next 版本：

npm install -g n8n@next

安装后，通过运行以下命令启动 n8n：

n8n
# 或
n8n start

后续步骤#

使用快速入门试用 n8n。

更新#

要将您的 n8n 实例更新到 latest 版本，请运行：

npm update -g n8n

要安装 next 版本：

npm install -g n8n@next

使用隧道的 n8n#

Danger

仅用于本地开发和测试。在生产环境中使用不安全。

开发工具

隧道功能是一个用于本地开发的便利工具。其底层实现可能会在 n8n 版本之间发生变化。

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

根据你运行 n8n 的方式，有两种使用隧道的方法：

需要 Docker

隧道使用 cloudflared，它作为 Docker 容器运行。即使通过 npm 运行 n8n，也请确保你的机器上已安装 Docker。

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

# Terminal 1: Start the cloudflared tunnel service
pnpm --filter n8n-containers services --services cloudflared

# Terminal 2: Start n8n locally
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 隧道设置。

回退升级#

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

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

检查功能文档和发布说明，看看是否有需要手动进行的更改。
在当前版本上运行 n8n db:revert 来回滚数据库。如果您想回退多个数据库迁移，需要重复此过程。

Windows 故障排除#

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