liujiayu/n8n-guide

Fork 0

Files

嘉宇刘 20bf2449e0 first commit

2025-09-11 14:00:33 +08:00

3.9 KiB

Raw Blame History

n8n汉化

📚 学习资源

汉化教程：n8n汉化指南
官方文档：n8n官方文档
中文文档：n8n中文文档

在使用Docker部署时，可以通过添加环境变量的方式实现界面汉化。

🌏 汉化的必要性

为什么需要汉化

👥

团队协作

降低团队成员的学习门槛，提高工作效率

📖

理解准确

避免因语言理解偏差导致的配置错误

🎯

专注业务

减少语言障碍，专注于业务逻辑设计

🚀

快速上手

新用户能更快熟悉界面和功能

🐳 Docker部署汉化方案

环境变量汉化

最简单的汉化方式是通过环境变量设置：

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
功能异常	汉化后功能出错	使用官方语言包版本

验证汉化是否成功

# 检查容器环境变量
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完整汉化指南
官方多语言支持: n8n Internationalization
社区汉化项目: GitHub上的中文社区维护版本

通过汉化，您的团队可以更高效地使用n8n，减少语言障碍带来的学习成本。

上一章：凭证管理{ .md-button } 下一章：常用节点{ .md-button .md-button--primary }

3.9 KiB Raw Blame History Unescape Escape