大家好，我是 Dr.N8N。我一直致力于将 n8n 打造成企业级、生产就绪的自动化平台。在众多客户的实践落地中，我发现一个普遍但又必须解决的痛点：n8n 官方版本缺乏完整的中文本地化支持。
虽然 n8n 提供了强大的 i18n（国际化）框架，但核心 UI 语言包的缺失，让国内的技术团队在配置复杂的 Agent 工作流或进行日常运维时，不得不面对大量的英文界面，这严重影响了效率和上手速度。
今天，我将基于社区项目 n8n-i18n-chinese ，为你提供一套专业、可复现、且适用于生产环境的 n8n Docker Compose 中文集成方案。这不仅仅是安装，更是关乎数据安全、版本锁定和 Agent 稳定性的高级运维实践。
为什么 Docker 是实现中文本地化的唯一选择？
很多新手会问：为什么我不能直接用 npm install n8n -g 然后手动复制文件？
我必须严肃指出：在生产环境中，这种思路是错误的。
n8n-i18n-chinese 的工作原理是 “替换” n8n 核心前端模块 n8n-editor-ui 的编译输出文件（即 dist 目录）。在原生 NPM 环境中，定位到全局安装的 n8n 模块路径是一场灾难（例如 Linux 上是 /usr/local/lib/node_modules ，Windows 路径更复杂）。
相比之下，容器化（Docker） 部署提供了精确、可控的文件系统。我们只需要通过 卷映射（Volume Mapping） 机制，将宿主机上的汉化文件精准地注入到容器内部的固定路径，从而实现非侵入式的定制 。这是保证部署可复现性和稳定性的基石。
生产级 n8n 环境配置清单 (Agent Workflows 必备)
在讨论汉化前，我们必须先构建一个稳定的生产级基础架构。Agent 工作流的特点是高并发、高依赖和高时效性，因此，你需要专业的配置：
- 数据库选型： 放弃默认的 SQLite。SQLite 不支持高并发，无法支撑多用户或复杂的 Agent 任务。必须使用 PostgreSQL 或 MySQL 来保证工作流和凭证数据的持久性和高可靠性 。
- 数据持久化： 必须映射 n8n 的用户数据目录。
- 时区与语言设置： 通过环境变量精确配置，这对于基于 Cron 节点的 Agent 调度至关重要。
| 环境变量 | 用途描述 | 推荐设置 |
| N8N_DEFAULT_LOCALE | UI 默认显示语言，触发加载汉化包。 | zh-CN |
| GENERIC_TIMEZONE | n8n 实例内部时区，确保定时任务的准确性。 | Asia/Shanghai |
| NODE_ENV | 运行模式。 | production |
核心：n8n-i18n-chinese 的集成与版本锁定
这里是汉化成功的关键。由于社区汉化包是对 n8n 核心代码的补丁，我们面临一个高风险问题：版本匹配。
【严重风险警告】 Dr.N8N 经验：
你下载的 n8n-i18n-chinese 补丁版本（例如 v1.37.0）必须与你使用的 n8n Docker 镜像版本（例如 n8nio/n8n:1.37.0）完全一致 。如果版本不匹配，UI 加载将失败，导致白屏或功能异常。因此，请务必锁定你的 n8n 镜像标签，不要使用 :latest。
步骤一：获取并解压汉化文件
访问 other-blowsnow/n8n-i18n-chinese 的 Releases 页面 ，下载与你 n8n 版本完全对应的 ZIP 包，并将其解压到你的项目目录下，例如 ./i18n/dist。
步骤二：精确的 Docker Volume 卷映射
在你的 docker-compose.yml 文件中，为 n8n 服务添加两个关键的 volumes 映射：
- 用户数据：
./data:/home/node/.n8n - 汉化补丁： 将宿主机上的汉化文件目录映射到容器内部的 UI 资源路径。
关键映射路径：
/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist
完整的 Docker Compose 示例 (极简版)
以下是一个集成汉化补丁和 PostgreSQL 的最小可运行配置：
version: '3.8'
services: n8n: image: n8nio/n8n:1.37.0 # ⚠️ 务必锁定版本，保持与汉化包一致 container_name: n8n_chinese restart: unless-stopped ports: - "5678:5678" environment: # n8n 配置 - N8N_DEFAULT_LOCALE=zh-CN - GENERIC_TIMEZONE=Asia/Shanghai - NODE_ENV=production # PostgreSQL 连接 - DB_TYPE=postgresdb - DB_POSTGRESDB_HOST=postgres - DB_POSTGRESDB_DATABASE=n8n - DB_POSTGRESDB_USER=n8n_user - DB_POSTGRESDB_PASSWORD=YOUR_SECRET_PASSWORD volumes: # 1. 核心数据持久化 -./data:/home/node/.n8n # 2. 汉化 UI 资源注入 (核心步骤) -./i18n/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist depends_on: - postgres
postgres: image: postgres:15 container_name: n8n_postgres restart: unless-stopped environment: - POSTGRES_DB=n8n - POSTGRES_USER=n8n_user - POSTGRES_PASSWORD=YOUR_SECRET_PASSWORD volumes: -./postgres-data:/var/lib/postgresql/data # DB 数据持久化
执行 docker compose up -d 启动服务后，访问 http://localhost:5678 即可看到完整的中文界面。
Agent 落地与专业运维（Dr.N8N 经验总结）
安装和汉化只是第一步。要让 n8n 成为可靠的 Agent 自动化中枢，你需要关注以下专业实践：
- 错误处理回路（Error Handling）： Agent 依赖外部 API（如 LLM 或 RAG）。一旦 API 响应失败，线性工作流会崩溃 。永远不要忘记添加
Error Trigger 和 Error Catch 节点，将关键工作流包装在子工作流中，实现优雅的回退机制。 - 模块化与复用： 我强烈建议将通用功能（如 LLM 调用、速率限制、数据清洗）抽象为子工作流 。这不仅提升了代码复用性，也使得 Agent 工具路由（Tool Routing）的逻辑更加清晰。
- 安全性与配置隔离： 生产环境必须配置反向代理启用 HTTPS ，并确保所有敏感信息（API Keys、LLM 密钥）都存储在 n8n 的 Credentials 或宿主机环境变量中，绝不硬编码 。
- 可扩展性： 确保 Node.js 版本满足最新要求（推荐 Node 18.17.0+ ），以便未来集成更复杂的自定义节点或 NPM 模块。
总结
通过本次教程，你成功搭建了一个具有中文界面的、生产级 n8n 自动化平台。核心决策清单如下：
- 架构： Docker Compose + PostgreSQL (for Production)
- 汉化： 采用
n8n-i18n-chinese 补丁包。 - 关键指令： 锁定 n8n 版本 并精确映射卷路径：
./i18n/dist -> /usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist 。 - 时区： 必须设置
GENERIC_TIMEZONE=Asia/Shanghai 。
如果你在 Agent 落地过程中遇到任何性能或稳定性问题，请记住：稳定胜于一切花哨的功能。下次，我将探讨如何通过 n8n 的队列机制（Queue Mechanism）来优化高并发 Agent 调度的限速与重试策略。
参考资料
- n8n 官方 Docker Compose 部署文档
- n8n 官方时区与本地化环境变量
- n8n-i18n-chinese 项目 GitHub Releases
- n8n 社区汉化指南与 Docker 路径讨论
你认为 n8n 官方是否应该将中文本地化资源包内置到主分支中？在评论区分享你的看法！
—— Dr.N8N 敬上
