logo
8
1
WeChat Login
编辑文件 readme.md

n8n 是一个可扩展的工作流自动化工具。本教程将分别介绍如何在云开发环境(CNB)和标准云服务器(Claw Cloud)上通过 Docker 进行部署。

目录

1. 方案 1: 在 CNB.cool 上部署 (适合测试/开发)

2. 方案 2: 在 Claw Cloud 上部署 (适合生产环境)

3. 常见问题与后续配置

Fork 项目后点击启动n8n 进入环境后等待2分钟左右n8n自动启动。登陆即可以使用。

云原生开发

方案 1: 在 CNB.cool 上部署

适用场景:快速体验、测试工作流、开发环境。 注意:CNB 是云端 IDE,工作空间在长期不操作后会休眠,因此不适合运行需要 24/7 在线监听的生产级工作流。

步骤 1: 创建项目

  1. 登录 cnb.cool。
  2. 点击右上角 + 号,选择“新建代码库”。
  3. 输入名称(例如 n8n-demo),可见性设为私有或公开均可,点击“创建”。 步骤

步骤 2: 直接打开 "云开发环境"

点击"云原生开发" 按钮 云原生开发

输入命令 输入命令:

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" 粘贴后回车

出来以下提示允许即可:

等待部署完成

步骤 3: 访问 n8n

  1. 启动成功后,CNB 会检测到 5678 端口被占用。
  2. 在右下角弹出的通知中点击 "Open in Browser" (在浏览器打开)。
  3. 或者在 IDE 顶部的 "Ports" (端口) 面板中找到 5678 端口的“本地地址/访问链接”。

输入命令


方案 2: 在 Claw Cloud 上部署 适用场景:长期稳定运行、生产环境、需要公网 Webhook 接收数据。 前提:你需要购买一台 Linux 服务器(推荐 Ubuntu 22.04 或 Debian 11/12)。 步骤 1: 准备服务器

  1. 通过提供的链接登录 Claw Cloud Console。
  2. 创建实例(Create Instance):
  • Image: 选择 Ubuntu 22.04 LTS。
  • Region: 选择离你或你目标用户最近的地区。
  • Spec: 建议至少 2vCPU / 2GB RAM(n8n 比较吃内存)。
  1. 确保安全组(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

安装 Docker (使用官方脚本)

curl -fsSL https://get.docker.com | bash

验证安装

docker --version 步骤 3: 部署 n8n 创建一个目录并配置 n8n: Bash

创建目录

mkdir n8n cd n8n

创建 docker-compose.yml 文件

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: 访问与设置

  1. 打开浏览器,访问 http://你的服务器IP:5678。
  2. 首次访问会要求你创建管理员账户(邮箱和密码)。
  3. 如果无法访问,请检查 Claw Cloud 控制台的防火墙/安全组设置,确保 TCP 5678 端口已放行。

常见问题与后续配置

  1. 数据持久化 上述两个方案都使用了 Docker Volumes (n8n_data)。这意味着即使你重启容器,你的工作流和账号数据也会保留。
  • CNB 注意事项:如果你删除了 CNB 的代码库或彻底重置了环境,Volume 数据可能会丢失。建议定期导出工作流 JSON。
  • Claw Cloud:数据保存在服务器本地 Docker 卷中,比较安全。
  1. 关于 Webhook (生产环境必读) 如果你需要 n8n 接收外部应用(如 GitHub 推送、表单提交)的 Webhook:
  • CNB:生成的访问链接通常是动态的或经过鉴权的,不适合作为稳定的 Webhook 地址。
  • Claw Cloud:建议购买一个域名,并配置 Nginx 反向代理加 SSL 证书(可以使用 Nginx Proxy Manager),将域名指向 5678 端口。然后在 docker-compose.yml 中添加环境变量 WEBHOOK_URL=https://你的域名。
  1. 系统资源 n8n 也是 Node.js 应用,当处理大量数据时可能会消耗较多内存。
  • 如果 n8n 经常崩溃,请检查 Claw Cloud 实例的内存占用,可能需要升级配置或增加 Swap 分区。
  1. 总结对比 暂时无法在飞书文档外展示此内容