npm#
npm 是在本地计算机上快速开始使用 n8n 的方式。您必须已安装 Node.js。n8n 需要 Node.js 版本在 20.19 至 24.x 之间（含边界版本）。
最新版与预览版
n8n 每周会发布新的次要版本。latest 版本适用于生产环境，next 则是最新发布的版本。您应将 next 视为测试版：它可能不稳定。如需报告问题，请使用社区论坛。
当前 latest 版本：1.119.2
当前 next 版本：1.119.3
通过 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 # or n8n start
后续步骤#
通过快速入门指南体验n8n。
更新操作#
如需将n8n实例更新至latest版本，请运行：
npm update -g n8n
要安装 next 版本：
npm install -g n8n@next
使用隧道的 n8n#
危险提示
此功能仅适用于本地开发与测试，在生产环境中使用存在安全风险。
若需为 GitHub 等外部服务的触发节点配置网络钩子，n8n 必须能够从公网访问。n8n 运行了一项隧道服务，可将来自 n8n 服务器的请求重定向至您的本地 n8n 实例。
通过以下命令启动带 --tunnel 参数的 n8n：
n8n start --tunnel
回退升级版本#
安装您需要回退的旧版本。
若升级涉及数据库迁移：
- 查阅功能文档与版本说明，确认是否存在需手动修改的内容
- 在当前版本执行
n8n db:revert命令回滚数据库。如需回退多个数据库迁移版本，请重复执行此操作
Windows 故障排除#
若在 Windows 系统运行 n8n 时遇到问题，请确保 Node.js 环境配置正确。参照微软官方指南《在 Windows 上安装 NodeJS》进行配置。