【N8N汉化教程】告别英文界面,一步到位配置中文UI!

大家好!很多朋友刚开始接触强大的自动化工具 N8N 时,可能会被其全英文的操作界面劝退,尤其是对英文不太熟悉的同学。虽然可以用浏览器插件进行沉浸式翻译,但毕竟不如原生中文界面用起来顺畅。

有没有办法在安装 N8N 的时候就直接用上中文界面呢?

答案是肯定的!感谢大佬的贡献,我们有 N8N 的汉化包。这里我就给大家分享这个汉化包的来源以及如何在 Docker 环境下配置 N8N,让你从一开始就拥有中文界面。


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


2. 汉化原理简述

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


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

  1. 下载汉化包: 访问上面提供的 GitHub 项目地址,找到 Release 页面,下载最新版本的 editor-ui.tar.gz 文件。
  2. 上传到你的服务器: 将下载好的 editor-ui.tar.gz 文件上传到你的 Linux 服务器上。
  3. 选择一个存放目录并解压:
    • 在你的服务器上选择一个目录来存放解压后的汉化文件。这个目录是宿主机(你的服务器)上的路径。例如,你可以创建一个目录 /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 服务配置中,添加或修改 volumesenvironment 部分。

    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 -ddocker-compose up -d --force-recreate

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


6. 注意事项

  • 路径替换: 请务必将示例中的 /opt/n8n_zh_ui/dist 替换成你宿主机上实际存放解压后 dist 目录的绝对路径。
  • 绝对路径: 强烈建议在 -vvolumes 配置中使用绝对路径,避免相对路径带来的潜在问题。
  • 汉化完整度: 这个汉化包主要针对 N8N 的 UI 界面,节点(Nodes)的描述和选项汉化程度取决于汉化包的更新情况,可能不是 100% 完整。
  • N8N 版本: 汉化包可能与某些 N8N 版本存在兼容性问题,如果遇到问题,可以尝试使用汉化包作者推荐的 N8N 版本。
  • 其他汉化包: 如果未来有其他类似的汉化包,其使用方法通常也是类似的:下载汉化文件,解压到宿主机,然后通过 Docker 卷映射替换容器内的 UI 文件,并设置语言环境变量。
1 个赞

挺好的,稍后我也会把链接加到教程贴里。

但其实对纯小白来说,不建议用汉化包,因为大部分 n8n 的答疑资源还是英文的。用汉化包的话,遇到问题都很难搜。

有个问题,如果n8n官方更行了版本,你这个汉化会自动更新吗,还是说要等别人做好了,重新这些操作步骤汉化

所以可以做一个插件,切换语言

不需要,映射好了一直都可以用

不需要重复后面的所有步骤,但汉化包是要等更新的。