大家好!很多朋友刚开始接触强大的自动化工具 N8N 时,可能会被其全英文的操作界面劝退,尤其是对英文不太熟悉的同学。虽然可以用浏览器插件进行沉浸式翻译,但毕竟不如原生中文界面用起来顺畅。
有没有办法在安装 N8N 的时候就直接用上中文界面呢?
答案是肯定的!感谢大佬的贡献,我们有 N8N 的汉化包。这里我就给大家分享这个汉化包的来源以及如何在 Docker 环境下配置 N8N,让你从一开始就拥有中文界面。
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
解压到你选择的目录。# 假设你将 editor-ui.tar.gz 上传到了 /tmp/ 目录 # 假设你想将汉化文件存放在 /opt/n8n_zh_ui/ 这个宿主机目录 mkdir -p /opt/n8n_zh_ui/ # 创建存放目录(如果不存在) tar -xzf /tmp/editor-ui.tar.gz -C /opt/n8n_zh_ui/
- 解压后,在
/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 -it --rm --name n8ntest \ -p 15678:5678 \ -e N8N_SECURE_COOKIE=false \ n8nio/n8n
-
修改后的
docker run
命令:
主要增加了-v
参数用于卷映射,以及-e N8N_DEFAULT_LOCALE=zh-CN
设置默认语言。docker run -it --rm --name n8ntest \ -p 15678:5678 \ -v /opt/n8n_zh_ui/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \ -e N8N_DEFAULT_LOCALE=zh-CN \ -e N8N_SECURE_COOKIE=false \ n8nio/n8n
解释:
-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
部分。version: '3.8' services: n8n: # 服务名称可以自定义,这里用 n8n image: n8nio/n8n:{version} # 请替换 {version} 为你需要的 N8N 版本,例如 n8nio/n8n:latest 或 n8nio/n8n:1.0.0 container_name: n8n # 容器名称也可以自定义,这里用 n8n ports: - "15678:5678" # 根据你的需要修改宿主机端口 environment: - N8N_DEFAULT_LOCALE=zh-CN # 设置默认语言为简体中文 # 其他环境变量... # - N8N_SECURE_COOKIE=false # 如果需要,可以加上 volumes: # 卷映射:将宿主机的汉化文件目录映射到容器内的UI目录 - /opt/n8n_zh_ui/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist # 其他卷映射(如数据持久化)... # - ~/.n8n:/home/node/.n8n # 示例:N8N 数据持久化目录 stdin_open: true tty: true restart: unless-stopped # 容器退出后总是重启
解释:
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 文件,并设置语言环境变量。