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

# 📦 Windows 快速部署指南

<div align="center">
  <h2>n8n 工作流自动化平台 - Windows 部署方案</h2>
  <p>从零开始，10分钟完成部署</p>
</div>

---

## 🎯 部署目标

本指南将帮助你在 Windows 系统上快速部署 n8n 工作流自动化平台，包括：
- ✅ n8n 最新版本安装
- ✅ 网络环境配置
- ✅ 账户注册设置
- ✅ 中文界面配置

---

## 📋 前置准备

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

### 2. 核心依赖 - Node.js

#### 2.1 下载安装 Node.js
1. 访问 [Node.js 官网](https://nodejs.org/)
2. 下载 **LTS 版本**（长期支持版）
3. 运行安装程序，保持默认设置即可

#### 2.2 验证安装
打开 **命令提示符** (CMD) 或 **PowerShell**：
```bash
# 查看 Node.js 版本
node --version
# 应显示: v18.x.x 或更高

# 查看 npm 版本
npm --version
# 应显示: 9.x.x 或更高
```

---

## 🌐 网络配置（关键步骤）

> ⚠️ **重要提示**：n8n 安装过程需要访问国际网络资源，这是部署成功的关键。

### 方案一：配置 npm 镜像（国内用户推荐）

```bash
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry
```

### 方案二：配置系统代理（如有 VPN）

```bash
# 设置 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
```

### 方案三：网络连通性测试

```bash
# Windows 下测试网络连通性
# 如果使用代理，确保能访问：
curl https://registry.npmjs.org

# 或使用 ping 测试（部分网络可能禁 ping）
ping google.com
```

> 💡 **提示**：如果网络配置有问题，npm 安装会出现超时错误。请确保网络配置正确后再继续。

---

## 🚀 安装 n8n

### 1. 全局安装 n8n

```bash
# 使用 npm 全局安装最新版 n8n
npm install -g n8n

# 安装过程可能需要 3-5 分钟，请耐心等待
```

### 2. 验证安装

```bash
# 查看 n8n 版本
n8n --version
```

### 3. 常见安装问题解决

#### 问题 1：权限不足
```bash
# 以管理员身份运行 PowerShell，然后执行：
npm install -g n8n --unsafe-perm=true --allow-root
```

#### 问题 2：安装超时
```bash
# 增加超时时间
npm config set timeout 60000
npm install -g n8n
```

#### 问题 3：Python 依赖错误
部分 n8n 依赖需要 Python，如遇到相关错误：
1. 安装 [Python 3.x](https://www.python.org/downloads/)
2. 或安装 Windows Build Tools：
```bash
npm install -g windows-build-tools
```

---

## 🎬 启动 n8n

### 1. 首次启动

```bash
# 在命令行中运行
n8n

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

### 2. 初始设置

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

1. **创建账户**
   - 输入邮箱地址（可使用任意邮箱）
   - 设置密码（至少 8 位）
   - 填写基本信息

2. **选择使用方式**
   - 个人使用：选择 "Personal"
   - 团队使用：选择 "Work"

3. **完成设置**
   - 跳过可选的设置步骤
   - 进入 n8n 工作流编辑器

### 3. 配置中文界面（可选）

如果需要中文界面，可以：

```bash
# 停止 n8n (Ctrl+C)

# 设置环境变量后启动
set N8N_DEFAULT_LOCALE=zh-CN
n8n
```

或创建启动脚本 `start-n8n.bat`：
```batch
@echo off
set N8N_DEFAULT_LOCALE=zh-CN
set N8N_PORT=5678
echo Starting n8n with Chinese interface...
n8n
```

---

## 🔧 进阶配置

### 1. 使用配置文件

创建 `.n8n` 文件夹和配置：
```bash
# 创建配置目录
mkdir %USERPROFILE%\.n8n

# 创建环境配置文件
echo N8N_DEFAULT_LOCALE=zh-CN > %USERPROFILE%\.n8n\config
```

### 2. 数据持久化

n8n 默认将数据保存在：
- Windows: `%USERPROFILE%\.n8n`
- 包含：工作流、凭证、设置等

### 3. 后台运行

#### 使用 PM2（推荐）
```bash
# 安装 PM2
npm install -g pm2

# 使用 PM2 启动 n8n
pm2 start n8n

# 查看运行状态
pm2 status

# 停止 n8n
pm2 stop n8n
```

#### 使用 Windows 服务
```bash
# 安装 node-windows
npm install -g node-windows

# 创建服务脚本（需要额外配置）
```

---

## 📊 部署验证清单

完成以下检查，确保部署成功：

- [ ] Node.js 安装成功（`node --version`）
- [ ] npm 可正常使用（`npm --version`）
- [ ] 网络连接正常（能访问 npm registry）
- [ ] n8n 安装完成（`n8n --version`）
- [ ] n8n 服务启动（http://localhost:5678 可访问）
- [ ] 账户注册完成
- [ ] 可以创建第一个工作流

---

## 🆘 故障排查

### 1. 端口占用
```bash
# 查看 5678 端口占用
netstat -ano | findstr :5678

# 使用其他端口启动
set N8N_PORT=5679
n8n
```

### 2. 防火墙问题
- Windows Defender 可能阻止 n8n
- 允许 Node.js 通过防火墙
- 或临时关闭防火墙测试

### 3. 查看日志
```bash
# 启用详细日志
set N8N_LOG_LEVEL=debug
n8n
```

### 4. 重置 n8n
```bash
# 删除配置和数据（谨慎操作）
rmdir /s %USERPROFILE%\.n8n

# 重新启动
n8n
```

---

## 🎯 快速启动脚本

创建 `quick-start.bat` 文件，实现一键启动：

```batch
@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](https://docs.n8n.io/)
- **社区论坛**: [community.n8n.io](https://community.n8n.io/)
- **GitHub Issues**: [github.com/n8n-io/n8n](https://github.com/n8n-io/n8n/issues)
- **本项目文档**: 查看项目根目录 README.md

---

<div align="center">
  <h3>🎉 部署完成！</h3>
  <p>现在你可以开始创建自动化工作流了</p>
  <br/>
  <p><i>如遇问题，请检查网络配置是否正确</i></p>
</div>