n8n 汉化版部署

n8n 是一款强大的开源自动化工作流工具，支持通过可视化界面创建复杂的工作流，广泛用于数据处理、API 集成和任务自动化。本文介绍如何通过 Docker 或 Docker Compose 部署 n8n 汉化版（默认中文界面），并通过自定义参数实现数据持久化、解除访问限制等优化，适合开发测试和生产环境。

发布日期：2025年6月12日 | 作者：Kayin | 阅读时长：1分钟

1. 背景与优势

n8n 汉化版：基于 n8n 开源项目，默认界面语言为中文（zh-CN），更适合中文用户。
部署挑战：
- 官方 Docker 部署默认限制本地访问（127.0.0.1），不适合远程使用。
- 缺乏数据持久化配置，升级或重启可能丢失工作流。
- 部分节点功能（如本地文件监听）需额外配置。
优化目标：
- 解除访问限制，允许远程访问。
- 实现工作流数据持久化，确保升级不丢失数据。
- 启用工作流执行器，增强功能支持。

版本说明：本文基于 n8n 1.94.1 编写，建议替换为 latest 标签获取最新版本，或在 n8n GitHub 仓库查看特定版本号。

2. 部署方式

2.1 使用 Docker 部署

通过以下命令部署 n8n 汉化版，配置中文界面、持久化存储和远程访问：

docker run -d \
  --name n8ntest \
  -p 15678:5678 \
  -e N8N_DEFAULT_LOCALE=zh-CN \
  -e N8N_SECURE_COOKIE=false \ # 禁用 Cookie 安全检查（建议仅本地开发使用）
  -e N8N_HOST=0.0.0.0 \ # 允许所有 IP 访问
  -e N8N_RUNNERS_ENABLED=true \ # 启用工作流执行器
  -v $(pwd)/editor-ui-dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \
  -v n8n_data:/home/node/.n8n \ # 持久化工作流数据
  -v $(pwd)/data:/data \ # 自定义目录，支持文件监听节点
  --restart unless-stopped \
  -it \
  n8nio/n8n:latest # 建议使用 latest 标签，或指定版本如 1.94.1

2.2 使用 Docker Compose 部署

通过 Docker Compose 部署更易于管理和维护。以下是优化后的 docker-compose.yml 配置：

services:
  n8ntest:
    image: n8nio/n8n:latest # 建议使用 latest 标签，或指定版本如 1.94.1
    container_name: n8ntest
    ports:
      - "15678:5678"
    environment:
      - N8N_DEFAULT_LOCALE=zh-CN # 设置默认语言为中文
      - N8N_SECURE_COOKIE=false # 禁用 Cookie 安全检查（仅限本地开发）
      - N8N_HOST=0.0.0.0 # 允许所有 IP 访问
      - N8N_RUNNERS_ENABLED=true # 启用工作流执行器
    volumes:
      - ./editor-ui-dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist # 自定义 UI 文件
      - n8n_data:/home/node/.n8n # 持久化工作流数据
      - ./data:/data # 自定义目录，支持文件监听节点
    stdin_open: true
    tty: true
    restart: unless-stopped

volumes:
  n8n_data: # 定义持久化卷
    name: n8n_data

部署步骤

保存上述内容为 docker-compose.yml。
在文件所在目录运行：docker-compose up -d
访问 http://<服务器IP>:15678 检查 n8n 界面（默认中文）。

2.3 关键参数说明

参数	说明
`N8N_DEFAULT_LOCALE`	设置界面语言为中文（`zh-CN`）。
`N8N_SECURE_COOKIE`	禁用 Cookie 安全检查，简化本地开发（生产环境谨慎使用）。
`N8N_HOST`	设置为 `0.0.0.0`，允许远程访问，解除本地访问限制。
`N8N_RUNNERS_ENABLED`	启用工作流执行器，增强节点功能支持。
`volumes`	持久化 `/home/node/.n8n` 保存工作流，`/data` 支持文件监听节点。

3. 部署优势

远程访问：通过 N8N_HOST=0.0.0.0，支持从任意 IP 访问 n8n 界面。
数据持久化：工作流数据存储在 Docker 卷 n8n_data，升级或重启不丢失。
功能增强：启用工作流执行器，支持更多节点功能（如文件监听）。
汉化体验：默认中文界面，降低使用门槛。

4. 常见问题排查

4.1 无法访问 n8n 界面

现象：浏览器访问 http://<服务器IP>:15678 失败。
解决方法：
- 确认端口映射正确（15678:5678）。
- 检查 N8N_HOST 是否为 0.0.0.0。
- 确保防火墙允许 15678 端口。

4.2 工作流数据丢失

现象：容器重启后工作流丢失。
解决方法：
- 确认 volumes 配置正确，n8n_data 卷已挂载。
- 检查 ./data 目录权限，确保容器可读写。

4.3 部分节点功能受限

现象：文件监听等节点无法正常工作。
解决方法：
- 确保挂载 ./data:/data 目录。
- 确认 N8N_RUNNERS_ENABLED=true 已启用。

5. 总结

通过优化 Docker 或 Docker Compose 配置，n8n 汉化版可实现灵活的自动化工作流部署，支持中文界面、远程访问和数据持久化。相比官方默认部署，本方案解除访问限制、增强功能支持，并确保数据安全，适合开发测试和生产环境。如需使用最新版本，请替换镜像标签为 latest，或参考 n8n GitHub 仓库选择特定版本。