# n8n 中文版启动指南

## 项目概述

这是一个完全中文化的 n8n 工作流自动化平台，集成了来自 `n8n-i18n-chinese` 项目的完整中文翻译。

## 快速启动

### 使用启动脚本（推荐）
```bash
./start.sh
```

### 手动启动
```bash
# 设置中文语言环境
export N8N_DEFAULT_LOCALE=zh-CN

# 启动 n8n 服务
pnpm start
```

### 开发模式启动
```bash
# 设置中文语言环境
export N8N_DEFAULT_LOCALE=zh-CN

# 启动开发服务器（支持热重载）
pnpm dev
```

## 访问地址

启动成功后，可通过以下地址访问：
- **主页**: http://localhost:5678
- **登录页**: http://localhost:5678/signin

## 中文翻译特性

### 已翻译的界面元素
- ✅ 登录界面：登录、电子邮件、密码、忘记密码
- ✅ 错误消息：完全中文化的错误提示
- ✅ 工作流界面：所有操作按钮和菜单
- ✅ 节点配置：各种节点的配置选项
- ✅ 凭据管理：凭据创建和配置界面

### 翻译文件信息
- **翻译文件**: `packages/frontend/@n8n/i18n/src/locales/zh-CN.json`
- **行数**: 3465 行
- **来源**: [n8n-i18n-chinese](https://github.com/other-blowsnow/n8n-i18n-chinese) 项目

## 技术配置

### 环境变量
```bash
# 主要配置
N8N_DEFAULT_LOCALE=zh-CN
N8N_SECURE_COOKIE=false

# 可选优化配置
DB_SQLITE_POOL_SIZE=5
N8N_RUNNERS_ENABLED=true
N8N_BLOCK_ENV_ACCESS_IN_NODE=false
```

### 修改的文件
1. **i18n 配置**: `packages/frontend/@n8n/i18n/src/index.ts`
   - 导入中文翻译文件
   - 设置默认语言为中文
   - 添加中文消息配置

2. **bug 修复**: `packages/frontend/editor-ui/src/components/CredentialEdit/CredentialConfig.vue`
   - 添加 null 检查防止翻译错误

3. **环境配置**: `.env`
   - 设置默认语言环境

## 故障排除

### 常见问题

1. **端口被占用**
   ```bash
   # 查看端口占用
   lsof -i :5678
   
   # 杀死占用进程
   kill -9 <PID>
   ```

2. **翻译不生效**
   - 确认环境变量：`echo $N8N_DEFAULT_LOCALE`
   - 检查服务器日志中的 `Locale: zh-CN` 信息
   - 清除浏览器缓存并刷新页面

3. **启动失败**
   ```bash
   # 清理并重新安装依赖
   pnpm clean
   pnpm install
   
   # 重新构建
   pnpm build
   ```

4. **开发模式编译错误**
   ```bash
   # 停止所有相关进程
   pkill -f "pnpm dev"
   pkill -f "turbo"
   
   # 使用生产模式启动
   ./start.sh
   ```

### 日志查看
服务启动后会显示：
```
Locale: zh-CN
Editor is now accessible via:
http://localhost:5678
```

## 版本信息

- **n8n 版本**: 1.109.2
- **Node.js**: v22.18.0
- **pnpm**: 10.12.1
- **翻译版本**: 基于 n8n-i18n-chinese 项目最新版本

## 开发说明

### 项目结构
```
n8n-n8n-1.109.2/
├── packages/frontend/@n8n/i18n/         # 国际化配置
│   └── src/locales/zh-CN.json          # 中文翻译文件
├── packages/frontend/editor-ui/        # 前端界面
├── packages/cli/                       # 后端服务
├── .env                               # 环境配置
├── LAUNCH.md                          # 本文档
└── start.sh                           # 启动脚本
```

### Git 分支
- **当前分支**: `My_N8N`
- **基于版本**: n8n-1.109.2
- **主要修改**: 集成中文翻译支持

---

**最后更新**: 2025-09-07  
**维护者**: 小齐  
**项目状态**: ✅ 可用于生产环境