大家好!很多朋友刚开始接触强大的自动化工具 N8N 时,可能会被其全英文的操作界面劝退,尤其是对英文不太熟悉的同学。虽然可以用浏览器插件进行沉浸式翻译,但毕竟不如原生中文界面用起来顺畅。
有没有办法在安装 N8N 的时候就直接用上中文界面呢?
答案是肯定的!感谢大佬的贡献,我们有 N8N 的汉化包。这里我就给大家分享这个汉化包的来源以及如何在 Docker 环境下配置 N8N,让你从一开始就拥有中文界面。
1. 汉化包来源与相关链接 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 设置默认语言。
解释:
-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 文件,并设置语言环境变量。