6.9 KiB
6.9 KiB
📦 Windows 快速部署指南
n8n 工作流自动化平台 - Windows 部署方案
从零开始，10分钟完成部署
🎯 部署目标
本指南将帮助你在 Windows 系统上快速部署 n8n 工作流自动化平台，包括：
- ✅ n8n 最新版本安装
- ✅ 网络环境配置
- ✅ 账户注册设置
- ✅ 中文界面配置
📋 前置准备
1. 系统要求
- 操作系统: Windows 10/11 (64位)
- 内存: 最低 4GB，推荐 8GB+
- 硬盘: 5GB 可用空间
- 网络: 可访问国际网络（重要）
2. 核心依赖 - Node.js
2.1 下载安装 Node.js
- 访问 Node.js 官网
- 下载 LTS 版本（长期支持版）
- 运行安装程序，保持默认设置即可
2.2 验证安装
打开 命令提示符 (CMD) 或 PowerShell：
# 查看 Node.js 版本
node --version
# 应显示: v18.x.x 或更高
# 查看 npm 版本
npm --version
# 应显示: 9.x.x 或更高
🌐 网络配置（关键步骤）
⚠️ 重要提示：n8n 安装过程需要访问国际网络资源，这是部署成功的关键。
方案一：配置 npm 镜像（国内用户推荐）
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证配置
npm config get registry
方案二：配置系统代理（如有 VPN）
# 设置 HTTP 代理
npm config set proxy http://your-proxy:port
npm config set https-proxy http://your-proxy:port
# 取消代理（如不需要）
npm config delete proxy
npm config delete https-proxy
方案三：网络连通性测试
# Windows 下测试网络连通性
# 如果使用代理，确保能访问：
curl https://registry.npmjs.org
# 或使用 ping 测试（部分网络可能禁 ping）
ping google.com
💡 提示：如果网络配置有问题，npm 安装会出现超时错误。请确保网络配置正确后再继续。
🚀 安装 n8n
1. 全局安装 n8n
# 使用 npm 全局安装最新版 n8n
npm install -g n8n
# 安装过程可能需要 3-5 分钟，请耐心等待
2. 验证安装
# 查看 n8n 版本
n8n --version
3. 常见安装问题解决
问题 1：权限不足
# 以管理员身份运行 PowerShell，然后执行：
npm install -g n8n --unsafe-perm=true --allow-root
问题 2：安装超时
# 增加超时时间
npm config set timeout 60000
npm install -g n8n
问题 3：Python 依赖错误
部分 n8n 依赖需要 Python，如遇到相关错误：
- 安装 Python 3.x
- 或安装 Windows Build Tools：
npm install -g windows-build-tools
🎬 启动 n8n
1. 首次启动
# 在命令行中运行
n8n
# n8n 将在以下地址启动：
# http://localhost:5678
2. 初始设置
首次访问 http://localhost:5678 时，需要：
-
创建账户
- 输入邮箱地址（可使用任意邮箱）
- 设置密码（至少 8 位）
- 填写基本信息
-
选择使用方式
- 个人使用：选择 "Personal"
- 团队使用：选择 "Work"
-
完成设置
- 跳过可选的设置步骤
- 进入 n8n 工作流编辑器
3. 配置中文界面（可选）
如果需要中文界面，可以：
# 停止 n8n (Ctrl+C)
# 设置环境变量后启动
set N8N_DEFAULT_LOCALE=zh-CN
n8n
或创建启动脚本 start-n8n.bat：
@echo off
set N8N_DEFAULT_LOCALE=zh-CN
set N8N_PORT=5678
echo Starting n8n with Chinese interface...
n8n
🔧 进阶配置
1. 使用配置文件
创建 .n8n 文件夹和配置：
# 创建配置目录
mkdir %USERPROFILE%\.n8n
# 创建环境配置文件
echo N8N_DEFAULT_LOCALE=zh-CN > %USERPROFILE%\.n8n\config
2. 数据持久化
n8n 默认将数据保存在：
- Windows:
%USERPROFILE%\.n8n - 包含：工作流、凭证、设置等
3. 后台运行
使用 PM2（推荐）
# 安装 PM2
npm install -g pm2
# 使用 PM2 启动 n8n
pm2 start n8n
# 查看运行状态
pm2 status
# 停止 n8n
pm2 stop n8n
使用 Windows 服务
# 安装 node-windows
npm install -g node-windows
# 创建服务脚本（需要额外配置）
📊 部署验证清单
完成以下检查，确保部署成功：
- Node.js 安装成功（
node --version） - npm 可正常使用（
npm --version） - 网络连接正常（能访问 npm registry）
- n8n 安装完成（
n8n --version） - n8n 服务启动（http://localhost:5678 可访问）
- 账户注册完成
- 可以创建第一个工作流
🆘 故障排查
1. 端口占用
# 查看 5678 端口占用
netstat -ano | findstr :5678
# 使用其他端口启动
set N8N_PORT=5679
n8n
2. 防火墙问题
- Windows Defender 可能阻止 n8n
- 允许 Node.js 通过防火墙
- 或临时关闭防火墙测试
3. 查看日志
# 启用详细日志
set N8N_LOG_LEVEL=debug
n8n
4. 重置 n8n
# 删除配置和数据（谨慎操作）
rmdir /s %USERPROFILE%\.n8n
# 重新启动
n8n
🎯 快速启动脚本
创建 quick-start.bat 文件，实现一键启动：
@echo off
echo ========================================
echo n8n Quick Start for Windows
echo ========================================
echo.
:: 检查 Node.js
echo [1/4] Checking Node.js...
node --version >nul 2>&1
if %errorlevel% neq 0 (
echo ERROR: Node.js not found! Please install Node.js first.
echo Download from: https://nodejs.org/
pause
exit /b 1
)
echo Node.js OK
:: 检查 n8n
echo [2/4] Checking n8n...
n8n --version >nul 2>&1
if %errorlevel% neq 0 (
echo n8n not found. Installing...
npm install -g n8n
)
echo n8n OK
:: 设置环境
echo [3/4] Setting environment...
set N8N_DEFAULT_LOCALE=zh-CN
set N8N_PORT=5678
echo Environment OK
:: 启动 n8n
echo [4/4] Starting n8n...
echo.
echo ========================================
echo n8n is starting at http://localhost:5678
echo Press Ctrl+C to stop
echo ========================================
echo.
n8n
📚 下一步
成功部署 n8n 后，你可以：
-
学习基础
- 创建第一个工作流
- 了解节点类型
- 掌握数据传递
-
探索集成
- 连接第三方服务
- 设置 Webhook
- 配置定时任务
-
进阶使用
- 自定义节点开发
- API 调用
- 工作流模板
📞 获取帮助
- 官方文档: docs.n8n.io
- 社区论坛: community.n8n.io
- GitHub Issues: github.com/n8n-io/n8n
- 本项目文档: 查看项目根目录 README.md
🎉 部署完成！
现在你可以开始创建自动化工作流了
如遇问题，请检查网络配置是否正确