146 lines
3.9 KiB
Markdown
146 lines
3.9 KiB
Markdown
# n8n汉化
|
||
|
||
## 📚 学习资源
|
||
|
||
- **汉化教程**：[n8n汉化指南](https://zhuanlan.zhihu.com/p/1937586953865372387)
|
||
- **官方文档**：[n8n官方文档](https://docs.n8n.io)
|
||
- **中文文档**：[n8n中文文档](https://docs.n8ncn.io)
|
||
|
||
在使用Docker部署时，可以通过添加环境变量的方式实现界面汉化。
|
||
|
||
## 🌏 汉化的必要性
|
||
|
||
### 为什么需要汉化
|
||
|
||
<div class="feature-grid">
|
||
<div class="feature-card">
|
||
<div class="feature-icon">👥</div>
|
||
<h3>团队协作</h3>
|
||
<p>降低团队成员的学习门槛，提高工作效率</p>
|
||
</div>
|
||
|
||
<div class="feature-card">
|
||
<div class="feature-icon">📖</div>
|
||
<h3>理解准确</h3>
|
||
<p>避免因语言理解偏差导致的配置错误</p>
|
||
</div>
|
||
|
||
<div class="feature-card">
|
||
<div class="feature-icon">🎯</div>
|
||
<h3>专注业务</h3>
|
||
<p>减少语言障碍，专注于业务逻辑设计</p>
|
||
</div>
|
||
|
||
<div class="feature-card">
|
||
<div class="feature-icon">🚀</div>
|
||
<h3>快速上手</h3>
|
||
<p>新用户能更快熟悉界面和功能</p>
|
||
</div>
|
||
</div>
|
||
|
||
## 🐳 Docker部署汉化方案
|
||
|
||
### 环境变量汉化
|
||
|
||
最简单的汉化方式是通过环境变量设置：
|
||
|
||
```yaml title="docker-compose.yml"
|
||
version: '3.8'
|
||
|
||
services:
|
||
n8n:
|
||
image: n8nio/n8n
|
||
container_name: n8n
|
||
restart: unless-stopped
|
||
ports:
|
||
- "5678:5678"
|
||
environment:
|
||
# 基础配置
|
||
- GENERIC_TIMEZONE=Asia/Shanghai
|
||
- N8N_DEFAULT_LOCALE=zh-CN
|
||
- N8N_DEFAULT_BINARY_DATA_MODE=filesystem
|
||
|
||
# 界面汉化
|
||
- LOCALE=zh-CN
|
||
- LC_ALL=zh_CN.UTF-8
|
||
- LANG=zh_CN.UTF-8
|
||
|
||
# 认证配置
|
||
- N8N_BASIC_AUTH_ACTIVE=true
|
||
- N8N_BASIC_AUTH_USER=admin
|
||
- N8N_BASIC_AUTH_PASSWORD=your-password
|
||
volumes:
|
||
- n8n_data:/home/node/.n8n
|
||
- /data/n8n/files:/files
|
||
|
||
volumes:
|
||
n8n_data:
|
||
```
|
||
|
||
|
||
|
||
## 🎨 界面汉化效果
|
||
|
||
### 汉化前后对比
|
||
|
||
| 功能区域 | 英文原版 | 中文汉化 |
|
||
|----------|----------|----------|
|
||
| **主菜单** | Workflows, Credentials, Executions | 工作流, 凭证, 执行历史 |
|
||
| **节点类型** | Triggers, Inputs, Processes, Outputs | 触发器, 输入, 处理, 输出 |
|
||
| **操作按钮** | Execute, Save, Activate, Settings | 执行, 保存, 激活, 设置 |
|
||
| **状态信息** | Running, Success, Error, Waiting | 运行中, 成功, 错误, 等待中 |
|
||
|
||
### 汉化覆盖范围
|
||
|
||
✅ **已汉化内容**:
|
||
- 主界面菜单和导航
|
||
- 节点分类和常用节点名称
|
||
- 工作流操作按钮
|
||
- 错误提示信息
|
||
- 设置界面选项
|
||
|
||
⚠️ **部分汉化内容**:
|
||
- 某些第三方节点名称
|
||
- 高级配置选项
|
||
- 开发者相关功能
|
||
|
||
❌ **未汉化内容**:
|
||
- 社区节点描述
|
||
- 技术文档链接
|
||
- 日志详细信息
|
||
|
||
## 🔧 汉化问题排查
|
||
|
||
### 常见问题和解决方案
|
||
|
||
| 问题 | 症状 | 解决方案 |
|
||
|------|------|----------|
|
||
| **语言包未生效** | 界面仍显示英文 | 检查挂载路径和环境变量 |
|
||
| **部分乱码** | 某些文字显示异常 | 确认字符集设置为UTF-8 |
|
||
| **功能异常** | 汉化后功能出错 | 使用官方语言包版本 |
|
||
|
||
### 验证汉化是否成功
|
||
|
||
```bash
|
||
# 检查容器环境变量
|
||
docker exec n8n env | grep -E "(LANG|LOCALE)"
|
||
|
||
# 检查语言包文件
|
||
docker exec n8n ls -la /usr/local/lib/node_modules/n8n/dist/packages/editor-ui/dist/static/locales/
|
||
|
||
# 查看n8n日志
|
||
docker-compose logs n8n | grep -i locale
|
||
```
|
||
|
||
## 📚 参考资源
|
||
|
||
- **详细汉化教程**: [n8n完整汉化指南](https://zhuanlan.zhihu.com/p/1937586953865372387)
|
||
- **官方多语言支持**: [n8n Internationalization](https://docs.n8n.io/hosting/configuration/#internationalization)
|
||
- **社区汉化项目**: GitHub上的中文社区维护版本
|
||
|
||
---
|
||
|
||
通过汉化，您的团队可以更高效地使用n8n，减少语言障碍带来的学习成本。
|
||
|
||
[上一章：凭证管理](credentials.md){ .md-button } [下一章：常用节点](../learning/common-nodes.md){ .md-button .md-button--primary }
|