如何在 Windows 系统上安装 n8n：两种方法详解

如何在 Windows 系统上安装 n8n：两种方法详解

摘要

本文详细介绍了在 Windows 系统上安装 n8n 的两种方法：直接安装和 Docker 部署。直接安装适合初学者，通过 Node.js 和 npm 快速完成；Docker 部署适合需要更高灵活性和可移植性的用户。文章还提供了常见问题的解决方案和注意事项，帮助用户顺利完成安装并高效使用 n8n。

一、引言

n8n 是一款开源的工作流自动化工具，支持通过可视化界面创建复杂的工作流。在 Windows 系统上安装 n8n 可以帮助用户轻松集成各种应用程序和服务，实现自动化任务。本文将介绍两种安装方法，并提供详细的操作步骤和注意事项。

二、方法一：直接安装（推荐）

1. 安装 Node.js 环境

n8n 基于 Node.js 开发，因此需要先安装 Node.js 及 npm 包管理器。

下载并安装 Node.js

• 访问 Node.js 官网。
• 下载 Windows 版本的 Node.js（建议选择 LTS 版本）。
• 运行安装程序，按照提示完成安装。

验证安装是否成功

打开 PowerShell，运行以下命令检查 Node.js 和 npm 是否安装成功：

node -v  # 显示 Node.js 版本号，如 v18.16.0
npm -v   # 显示 npm 版本号，如 9.5.1

如果命令返回版本号，则说明安装成功。

2. 全局安装 n8n

通过 npm 全局安装 n8n：

npm install n8n -g

安装完成后，可以通过以下命令验证：

n8n --version

3. 启动 n8n 服务

运行以下命令启动 n8n：

n8n

默认访问地址为 http://localhost:5678。如果需要自定义端口或配置数据库，可以使用参数调整，例如：

n8n --port=8080

三、方法二：Docker 部署

1. 启用 Windows 拟化支持

确保系统开启虚拟化功能：

• Windows 专业版/企业版：通过“启用或关闭 Windows 功能”勾选 Hyper-V 和 容器 选项。
• Windows 家庭版：需手动启用 Hyper-V（参考脚本配置方法）。

2. 安装 Docker Desktop

• 下载并安装 Docker Desktop for Windows。
• 安装完成后，启动 Docker 服务，并在终端验证：

docker --version

如果命令返回 Docker 版本号，则说明安装成功。

3. 拉取并运行 n8n 镜像

运行以下命令启动 n8n 容器：

docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

• -p 5678:5678：将容器的 5678 端口映射到本地。
• -v ~/.n8n:/home/node/.n8n：持久化存储工作流数据。

4. 安装后验证

在浏览器中输入 http://localhost:5678，如果显示 n8n 登录页面，则说明安装成功。

四、常见问题解决

1. 端口冲突

如果遇到端口冲突问题，可以修改启动命令中的端口号，例如：

docker run -d --name n8n -p 8080:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

2. 权限不足

如果遇到权限不足问题，可以尝试以下方法：

• 以管理员身份运行终端。
• 调整 Docker 容器的权限设置。

3. 数据库配置

在生产环境中，建议使用 PostgreSQL 数据库。可以通过环境变量配置数据库连接，例如：

docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n -e DB_TYPE=postgresql -e DB_POSTGRES_HOST=your-db-host -e DB_POSTGRES_USER=your-db-user -e DB_POSTGRES_PASSWORD=your-db-password n8nio/n8n

五、注意事项

1. 系统兼容性

• Windows 10/11 需为 64 位系统。
• 内存建议 ≥4GB。

2. 网络要求

• 使用 Docker 需保持网络畅通，避免镜像拉取失败。

3. 数据备份

定期备份 ~/.n8n 目录下的工作流数据，以防止数据丢失。

六、总结

本文详细介绍了在 Windows 系统上安装 n8n 的两种方法：直接安装和 Docker 部署。直接安装适合初学者，操作简单；Docker 部署适合需要更高灵活性和可移植性的用户。通过本文的指导，用户可以顺利完成安装并高效使用 n8n，实现工作流自动化。