部署自带中文的 n8n 工作流工具(Docker 方式)

本文介绍通过 <code>blowsnow/n8n-chinese</code> 镜像快速部署 n8n,该镜像已集成中文界面,便于国内用户使用。

部署示意图


方法一:修改宿主机目录权限(推荐)

此方法通过将本地数据目录的所有权改为容器内 <code>node</code> 用户(UID 1000),可避免因权限不足导致的写入问题。

操作步骤

  1. 创建本地数据目录(若已存在可跳过):
mkdir -p ~/.n8n
  1. 修改目录所有者为 UID 1000
sudo chown -R 1000:1000 ~/.n8n
  1. 启动容器
docker run -it -d --name n8ntest \
  -p 15678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e N8N_SECURE_COOKIE=false \
  -e NODES_EXCLUDE=[] \
  blowsnow/n8n-chinese

参数说明

参数 说明
<code>-it -d</code> 交互式 + 后台运行
<code>--name n8ntest</code> 指定容器名称,可自定义
<code>-p 15678:5678</code> 宿主机 15678 端口映射到容器 5678 端口(n8n 默认端口)
<code>-v ~/.n8n:/home/node/.n8n</code> 挂载本地目录,用于持久化工作流及配置
<code>-e N8N_SECURE_COOKIE=false</code> 关闭安全 Cookie(开发测试时使用,生产环境建议设为 <code>true</code>)
<code>-e NODES_EXCLUDE=[]</code> 排除不需要的节点(空数组表示不排除任何节点)
<code>blowsnow/n8n-chinese</code> 中文版 n8n 镜像

验证与访问

容器启动后,在浏览器中访问:

http://<你的服务器IP>:15678

即可看到 n8n 中文界面,开始创建工作流。


补充建议

  • 数据持久化:<code>~/.n8n</code> 目录会保存所有工作流、凭证和设置,请勿随意删除。
  • 生产环境安全:建议将 <code>N8N_SECURE_COOKIE</code> 设为 <code>true</code>,并使用反向代理(如 Nginx)配置 HTTPS。
  • 日志查看:若启动异常,可通过 <code>docker logs n8ntest</code> 查看错误日志。