Files

Yep_Q b7062e15cd feat: 添加启动文档和快速启动脚本

- 新增 LAUNCH.md 完整启动指南文档
  * 包含快速启动、手动启动、开发模式说明
  * 详细的中文翻译特性介绍
  * 环境变量配置说明
  * 故障排除指南
  * 项目结构说明

- 新增 start.sh 智能启动脚本
  * 支持正常启动和开发模式
  * 自动检查系统依赖和端口占用
  * 智能处理现有进程
  * 彩色日志输出和进度显示
  * 支持强制构建和仅检查模式

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-09-08 07:21:48 +08:00

3.4 KiB

Raw Permalink Blame History

n8n 中文版启动指南

项目概述

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

快速启动

使用启动脚本（推荐）

./start.sh

手动启动

# 设置中文语言环境
export N8N_DEFAULT_LOCALE=zh-CN

# 启动 n8n 服务
pnpm start

开发模式启动

# 设置中文语言环境
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 项目

技术配置

环境变量

# 主要配置
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

修改的文件

i18n 配置: packages/frontend/@n8n/i18n/src/index.ts
- 导入中文翻译文件
- 设置默认语言为中文
- 添加中文消息配置
bug 修复: packages/frontend/editor-ui/src/components/CredentialEdit/CredentialConfig.vue
- 添加 null 检查防止翻译错误
环境配置: .env
- 设置默认语言环境

故障排除

常见问题

端口被占用

# 查看端口占用
lsof -i :5678

# 杀死占用进程
kill -9 <PID>

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

启动失败

# 清理并重新安装依赖
pnpm clean
pnpm install

# 重新构建
pnpm build

开发模式编译错误

# 停止所有相关进程
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
维护者: 小齐
项目状态: ✅ 可用于生产环境

3.4 KiB Raw Permalink Blame History