飞牛Docker部署n8n及汉化教程

一、环境准备

1. 确认飞牛 Docker 支持

   飞牛私有云（fnOS）原生支持 Docker，需先在系统设置中启用 Docker 服务，并配置存储位置（建议选择容量充足的硬盘，避免后续修改）。

2. 准备工具
   • 飞牛 NAS 管理界面访问权限
   • 浏览器（用于后续访问 n8n）
   • 网络连接（确保可访问 Docker 镜像源）

二、部署步骤

1. 下载 n8n 镜像

1. 登录飞牛 NAS 管理界面，打开 Docker 应用。
2. 进入镜像仓库，搜索 n8nio/n8n，选择 latest 标签下载。
   • 若下载失败，添加 Docker 加速源：
     • 路径：Docker 设置 → 仓库设置 → 添加源
     • URL：https://registry.linkease.net:5443/（kspeeder 源）
     • 备注：kspeeder，启用并置顶加速源。

2. 创建存储目录

1. 通过飞牛文件管理，创建以下目录结构：
   plaintext

   /vol1/1000/Docker/n8n/
   ├─ n8n_data/       # 持久化n8n数据
   └─ zh-cn/          # 存放汉化文件
   

   Plaintext

   复制

2. 右键目录 → 详细信息 → 复制原始路径（如 /vol1/1000/Docker/n8n）备用。

3. 下载并配置汉化包

1. 下载汉化包：
   • GitHub 地址：n8n-i18n-chinese
   • 选择与 n8n 版本匹配的 editor-ui.tar.gz（如 n8n 1.111.0 对应汉化包 1.111.0）。

2. 解压汉化包至 zh-cn 目录，确保目录结构为：
   plaintext

   zh-cn/
   └─ dist/           # 汉化UI文件
   

   Plaintext

   复制

4. 启动 n8n 容器

1. 在 Docker 本地镜像中，选择 n8n 镜像 → 启动。
2. 配置容器参数：
   • 基本设置：
     • 容器名称：n8n
     • 开机自启：勾选

   • 端口设置：
     • 宿主端口：5678，容器端口：5678（默认，不可修改）

   • 存储位置：
     • 添加路径 1：n8n_data 目录 → 容器路径：/home/node/.n8n
     • 添加路径 2：zh-cn/dist 目录 → 容器路径：/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist

   • 环境变量：
     plaintext

     N8N_DEFAULT_LOCALE=zh-CN        # 默认中文
     N8N_SECURE_COOKIE=false         # 禁用HTTPS（如需HTTPS可省略）
     

     Plaintext

     复制

3. 点击创建，启动容器。

5. 访问 n8n 界面

1. 在浏览器输入 http://[飞牛IP]:5678。
2. 首次访问需填写真实邮箱（用于接收免费注册码），完成注册即可进入中文界面。

三、Docker Compose 配置（可选）

version: '3.8'
services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    ports:
      - "5678:5678"
    volumes:
      - /vol1/1000/Docker/n8n/n8n_data:/home/node/.n8n
      - /vol1/1000/Docker/n8n/zh-cn/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist
    environment:
      - N8N_DEFAULT_LOCALE=zh-CN
      - N8N_SECURE_COOKIE=false
    restart: unless-stopped

• 部署：Docker → Compose → 新建项目 → 粘贴上述内容 → 启动。

四、常见问题解决

1. 镜像下载失败：检查加速源配置，或手动拉取镜像后导入飞牛 Docker。
2. 汉化不生效：
   • 确认汉化包版本与 n8n 一致；
   • 检查 zh-cn/dist 路径映射是否正确。

3. 数据丢失：确保 n8n_data 目录正确挂载，容器重启后数据会自动恢复。

五、验证部署

• 访问 http://[飞牛IP]:5678，界面显示中文即为成功。
• 测试功能：创建简单工作流（如定时任务），确认节点名称及提示为中文。