Agent-n8n/doc/归档/windows快速部署.md

📦 Windows 快速部署指南

n8n 工作流自动化平台 - Windows 部署方案

从零开始，10分钟完成部署

---

🎯 部署目标

本指南将帮助你在 Windows 系统上快速部署 n8n 工作流自动化平台，包括：

• ✅ n8n 最新版本安装
• ✅ 网络环境配置
• ✅ 账户注册设置
• ✅ 中文界面配置

---

📋 前置准备

1. 系统要求

• 操作系统: Windows 10/11 (64位)
• 内存: 最低 4GB，推荐 8GB+
• 硬盘: 5GB 可用空间
• 网络: 可访问国际网络（重要）

2. 核心依赖 - Node.js

2.1 下载安装 Node.js

1. 访问 Node.js 官网
2. 下载 LTS 版本（长期支持版）
3. 运行安装程序，保持默认设置即可

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，如遇到相关错误：

1. 安装 Python 3.x
2. 或安装 Windows Build Tools：

npm install -g windows-build-tools

---

🎬 启动 n8n

1. 首次启动

# 在命令行中运行
n8n

# n8n 将在以下地址启动：
# http://localhost:5678

2. 初始设置

首次访问 http://localhost:5678 时，需要：

1. 创建账户

   • 输入邮箱地址（可使用任意邮箱）
   • 设置密码（至少 8 位）
   • 填写基本信息

2. 选择使用方式

   • 个人使用：选择 "Personal"
   • 团队使用：选择 "Work"

3. 完成设置

   • 跳过可选的设置步骤
   • 进入 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 后，你可以：

1. 学习基础

   • 创建第一个工作流
   • 了解节点类型
   • 掌握数据传递

2. 探索集成

   • 连接第三方服务
   • 设置 Webhook
   • 配置定时任务

3. 进阶使用

   • 自定义节点开发
   • API 调用
   • 工作流模板

---

📞 获取帮助

• 官方文档: docs.n8n.io
• 社区论坛: community.n8n.io
• GitHub Issues: github.com/n8n-io/n8n
• 本项目文档: 查看项目根目录 README.md

---

🎉 部署完成！

现在你可以开始创建自动化工作流了

如遇问题，请检查网络配置是否正确