n8n有中文版吗？如何汉化？ | 简单易懂的现代魔法

type

status

date

slug

summary

1. 汉化包来源与相关链接

原作者在 LINUX DO 的分享帖： 感谢原作者的辛勤工作，可以在这里了解更多背景信息。

【n8n汉化】教程 - 开发调优 - LINUX DO

核心资源 - GitHub 项目地址： 这是汉化包的发布地，请从这里下载最新的汉化文件。

n8n-i18n-chinese: n8n 配置多语言

2. 汉化原理简述

这个汉化方法的核心思路是：利用 Docker 的卷映射（Volume Mapping）功能，将我们下载并解压好的包含中文界面的文件挂载到 N8N 容器内对应的存放 UI 文件的目录，从而替换掉默认的英文 UI 文件。同时，通过设置环境变量告诉 N8N 默认使用中文。

3. 前置准备：下载并解压汉化包

下载汉化包： 访问上面提供的 GitHub 项目地址，找到 Release 页面，下载最新版本的 editor-ui.tar.gz 文件。

上传到你的服务器： 将下载好的 editor-ui.tar.gz 文件上传到你的 Linux 服务器上。

在你的服务器上选择一个目录来存放解压后的汉化文件。这个目录是宿主机（你的服务器）上的路径。例如，你可以创建一个目录 /opt/n8n_zh_ui/。

将 editor-ui.tar.gz 解压到你选择的目录。

解压后，在 /opt/n8n_zh_ui/ 目录下会看到一个名为 dist 的文件夹。这个 /opt/n8n_zh_ui/dist 路径就是我们后续 Docker 配置中需要用到的宿主机路径。

4. Docker 配置方法

接下来，我们通过配置 Docker 命令或 Docker Compose 文件来实现汉化。

方法一：使用 `docker run` 命令

如果你是直接使用 docker run 命令来启动 N8N 容器，请在原命令的基础上进行修改。

原 docker run 命令示例：

修改后的 docker run 命令：

主要增加了 -v 参数用于卷映射，以及 -e N8N_DEFAULT_LOCALE=zh-CN 设置默认语言。

解释：

v /opt/n8n_zh_ui/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist：这是关键的卷映射。

/opt/n8n_zh_ui/dist：这是你宿主机上存放解压后汉化文件的 dist 目录路径（请替换成你自己的实际路径！务必使用绝对路径）。
/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist：这是 N8N 容器内部存放 UI 文件的默认路径。Docker 会用你宿主机上的 /opt/n8n_zh_ui/dist 目录内容来覆盖或映射容器内的这个目录。

e N8N_DEFAULT_LOCALE=zh-CN：设置 N8N 的默认语言为简体中文。

方法二：使用 `docker-compose.yml` 文件

如果你使用 Docker Compose 来管理 N8N 容器，请修改你的 docker-compose.yml 文件。

在 services 下对应的 N8N 服务配置中，添加或修改 volumes 和 environment 部分。

解释：

image: n8nio/n8n:{version}：请务必替换 {version} 为你想要使用的 N8N 具体版本号，或者使用 latest。
environment: 下的 N8N_DEFAULT_LOCALE=zh-CN：作用同上，设置默认语言。
volumes: 下的 /opt/n8n_zh_ui/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist：作用同上，将宿主机路径 /opt/n8n_zh_ui/dist 映射到容器内的 /usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist。请将 /opt/n8n_zh_ui/dist 替换为你宿主机上实际的汉化文件 dist 目录路径！

5. 启动或重建容器

修改好你的 Docker 命令或 docker-compose.yml 文件后，请执行相应的命令来启动或重建 N8N 容器：

如果是 docker run 命令，直接执行修改后的命令即可。

如果是 docker-compose.yml，在文件所在目录下执行 docker-compose up -d 或 docker-compose up -d --force-recreate。

容器启动后，访问 N8N 的 Web 界面，应该就是中文界面了。

6. 注意事项

路径替换： 请务必将示例中的 /opt/n8n_zh_ui/dist 替换成你宿主机上实际存放解压后 dist 目录的绝对路径。

绝对路径： 强烈建议在 v 或 volumes 配置中使用绝对路径，避免相对路径带来的潜在问题。

汉化完整度： 这个汉化包主要针对 N8N 的 UI 界面，节点（Nodes）的描述和选项汉化程度取决于汉化包的更新情况，可能不是 100% 完整。

N8N 版本： 汉化包可能与某些 N8N 版本存在兼容性问题，如果遇到问题，可以尝试使用汉化包作者推荐的 N8N 版本。

其他汉化包： 如果未来有其他类似的汉化包，其使用方法通常也是类似的：下载汉化文件，解压到宿主机，然后通过 Docker 卷映射替换容器内的 UI 文件，并设置语言环境变量。

🇨🇳n8n有中文版吗？如何汉化？