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

方法一:修改宿主机目录权限(推荐)
此方法通过将本地数据目录的所有权改为容器内 <code>node</code> 用户(UID 1000),可避免因权限不足导致的写入问题。
操作步骤
- 创建本地数据目录(若已存在可跳过):
mkdir -p ~/.n8n
- 修改目录所有者为 UID 1000:
sudo chown -R 1000:1000 ~/.n8n
- 启动容器:
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> 查看错误日志。