b7062e15cd
- 新增 LAUNCH.md 完整启动指南文档 * 包含快速启动、手动启动、开发模式说明 * 详细的中文翻译特性介绍 * 环境变量配置说明 * 故障排除指南 * 项目结构说明 - 新增 start.sh 智能启动脚本 * 支持正常启动和开发模式 * 自动检查系统依赖和端口占用 * 智能处理现有进程 * 彩色日志输出和进度显示 * 支持强制构建和仅检查模式 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
154 lines
3.4 KiB
Markdown
154 lines
3.4 KiB
Markdown
# 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
|
|
**维护者**: 小齐
|
|
**项目状态**: ✅ 可用于生产环境 |