n8n 是一个可扩展的工作流自动化工具。本教程将分别介绍如何在云开发环境(CNB)和标准云服务器(Claw Cloud)上通过 Docker 进行部署。
目录
1. 方案 1: 在 CNB.cool 上部署 (适合测试/开发)
2. 方案 2: 在 Claw Cloud 上部署 (适合生产环境)
3. 常见问题与后续配置
Fork 项目后点击启动n8n 进入环境后等待2分钟左右n8n自动启动。登陆即可以使用。
适用场景:快速体验、测试工作流、开发环境。
注意:CNB 是云端 IDE,工作空间在长期不操作后会休眠,因此不适合运行需要 24/7 在线监听的生产级工作流。
- 登录 cnb.cool。
- 点击右上角 + 号,选择“新建代码库”。
- 输入名称(例如 n8n-demo),可见性设为私有或公开均可,点击“创建”。
步骤
点击"云原生开发" 按钮

输入命令:
docker run -itd --name n8n -p 5678:5678 -e N8N_SECURE_COOKIE=false -e GENERIC_TIMEZONE="Asia/Shanghai" -e TZ="Asia/Shanghai" -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
复制以上命令, 在窗口按"Ctrl + shift + v" 粘贴后回车
出来以下提示允许即可:
- 启动成功后,CNB 会检测到 5678 端口被占用。
- 在右下角弹出的通知中点击 "Open in Browser" (在浏览器打开)。
- 或者在 IDE 顶部的 "Ports" (端口) 面板中找到 5678 端口的“本地地址/访问链接”。

方案 2: 在 Claw Cloud 上部署
适用场景:长期稳定运行、生产环境、需要公网 Webhook 接收数据。
前提:你需要购买一台 Linux 服务器(推荐 Ubuntu 22.04 或 Debian 11/12)。
步骤 1: 准备服务器
- 通过提供的链接登录 Claw Cloud Console。
- 创建实例(Create Instance):
- Image: 选择 Ubuntu 22.04 LTS。
- Region: 选择离你或你目标用户最近的地区。
- Spec: 建议至少 2vCPU / 2GB RAM(n8n 比较吃内存)。
- 确保安全组(Security Group / Firewall)开放了 SSH (22) 和 n8n (5678) 端口。
步骤 2: 连接服务器并安装 Docker
使用 SSH 工具(如 Terminal, PuTTY, Xshell)连接服务器:
Bash
ssh root@你的服务器IP
连接成功后,执行以下命令安装 Docker 和 Docker Compose:
Bash
apt update && apt upgrade -y
curl -fsSL https://get.docker.com | bash
docker --version
步骤 3: 部署 n8n
创建一个目录并配置 n8n:
Bash
mkdir n8n
cd n8n
nano docker-compose.yml
将以下内容粘贴进去(注意修改域名部分,如果暂时没有域名,请删除 WEBHOOK_URL 这一行):
YAML
version: '3.8'services:n8n:image: n8nio/n8n:latestports:- "5678:5678"environment:- GENERIC_TIMEZONE=Asia/Shanghai- TZ=Asia/Shanghai# 如果你有域名,取消下面一行的注释并填入你的域名# - WEBHOOK_URL=https://n8n.yourdomain.comvolumes:- n8n_data:/home/node/.n8nrestart: alwaysvolumes:n8n_data:
按 Ctrl+O 保存,按 Enter 确认,然后按 Ctrl+X 退出编辑器。
步骤 4: 启动服务
Bash
docker compose up -d
步骤 5: 访问与设置
- 打开浏览器,访问 http://你的服务器IP:5678。
- 首次访问会要求你创建管理员账户(邮箱和密码)。
- 如果无法访问,请检查 Claw Cloud 控制台的防火墙/安全组设置,确保 TCP 5678 端口已放行。
常见问题与后续配置
- 数据持久化
上述两个方案都使用了 Docker Volumes (n8n_data)。这意味着即使你重启容器,你的工作流和账号数据也会保留。
- CNB 注意事项:如果你删除了 CNB 的代码库或彻底重置了环境,Volume 数据可能会丢失。建议定期导出工作流 JSON。
- Claw Cloud:数据保存在服务器本地 Docker 卷中,比较安全。
- 关于 Webhook (生产环境必读)
如果你需要 n8n 接收外部应用(如 GitHub 推送、表单提交)的 Webhook:
- CNB:生成的访问链接通常是动态的或经过鉴权的,不适合作为稳定的 Webhook 地址。
- Claw Cloud:建议购买一个域名,并配置 Nginx 反向代理加 SSL 证书(可以使用 Nginx Proxy Manager),将域名指向 5678 端口。然后在 docker-compose.yml 中添加环境变量 WEBHOOK_URL=https://你的域名。
- 系统资源
n8n 也是 Node.js 应用,当处理大量数据时可能会消耗较多内存。
- 如果 n8n 经常崩溃,请检查 Claw Cloud 实例的内存占用,可能需要升级配置或增加 Swap 分区。
- 总结对比
暂时无法在飞书文档外展示此内容