搬瓦工 VPS 上部署 n8n 智能体教程（个人/小规模使用）

本文为大家介绍如何在搬瓦工 VPS 上面部署 n8n 智能体，面向 2–4GB 内存场景，支持全站 HTTPS 与稳定 Webhook，可直连 OpenAI/Claude API。

1. 应用场景（AI 应用类别）

• AI 自动化中枢
  将邮件/表单/Webhook 接入，使用大模型（LLM）进行总结、分类、抽取，分发到 Notion、Slack、飞书或数据库。
• 智能客服/工单代理
  Webhook 触发 → 调用 OpenAI/Claude → 生成回复或检索知识库 → 写入工单系统。
• 数据管道与报表
  定时拉取 RSS/API → LLM 清洗与结构化 → 存入表格/DB → 周报推送。

2. 推荐配置（搬瓦工）

3. 部署总览（最小可用架构 MVA）

• 使用 Docker Compose 启动 n8n（单容器 + 持久化卷）
• 使用 Caddy 作为反向代理并自动申请 TLS（Let’s Encrypt）
• 仅暴露 80/443 端口，n8n 服务仅监听本机
• 关键环境变量：
  • N8N_HOST
  • N8N_PROTOCOL
  • WEBHOOK_URL
  • N8N_ENCRYPTION_KEY
  • TZ

4. 一步到位安装教程

步骤 1：基础准备

步骤 2：安装 Docker 与 Docker Compose

步骤 3：增加 Swap（内存 ≤ 4GB 强烈建议）

步骤 4：放通防火墙（如启用 UFW）

步骤 5：创建目录和配置文件

docker-compose.yml

Caddyfile

步骤 6：注入环境变量并启动

步骤 7：域名解析与访问

• 在域名 DNS 添加 A 记录，指向 VPS 公网 IP（Cloudflare 建议 DNS only）
• 浏览器访问 https://你的域名，创建管理员账号即可开始使用

5. 首个 AI 智能体（约 10 分钟）

1. 在 n8n Credentials 中添加 OpenAI（或使用 HTTP Request 调用 Claude）。
2. 新建 Workflow：
   • 触发器：Webhook（POST，Path 如 inbound），Production URL: https://你的域名/webhook/inbound
   • 处理：使用 OpenAI Chat 或 HTTP Request 调用 Claude，结合 Code/IF/Switch 做路由与清洗
   • 输出：使用 Respond to Webhook 返回 JSON，或写入 Notion/Sheets/飞书
3. 使用 curl 或 Postman 向 Production URL 发送测试数据，并查看执行结果。

6. 运维与升级

• 升级 n8n：
  cd /opt/n8n
docker compose pull
docker compose up -d

• 备份数据（离线快照）：
  mountpoint=$(docker volume inspect -f '{{ .Mountpoint }}' n8n_n8n_data)
systemctl stop docker
tar czf /root/n8n_backup_$(date +%F).tgz "$mountpoint"
systemctl start docker

• 日志排查：
  • docker logs -f n8n
  • docker logs -f caddy
  • Caddy 访问日志位于 caddy_data 卷中
• 安全建议：
  • 使用强密码
  • 禁用 root 直登或仅使用密钥登录
  • 必要时在 Caddy 前加 Basic Auth 或限制管理路径来源 IP

7. 性能与稳定性要点（2–4GB 主机经验）

• 内存与 Swap：2 GB RAM + 2 GB Swap 基本稳定；长流式或处理大 JSON 建议 4 GB RAM
• 连接超时：
  • Webhook 链路建议 < 60–90 秒；长任务改为异步：Webhook 接收 → 返回 202 → 后台处理 → 再回调/通知
  • 若使用 Cloudflare 代理，超时 100 秒：改 DNS only，或拆分长任务
• 大文件上传：遇到 HTTP 413 可在 Caddyfile 中添加：
  request_body {
max_size 50MB
}


  （适用于 Caddy v2.7+）

• 升级阈值：当工作流并发 > 5、LLM 请求平均时延 > 10 秒、内存常态占用 > 80% 或频繁 OOM 时，优先增加 RAM 或迁移到独立 DB/队列架构。

8. 可选增强（更强稳态）

• 数据库与队列：为 n8n 配置 Postgres（持久化更稳）与 Redis（队列/并发）
• 监控：Prometheus + cAdvisor 或 Netdata，设置磁盘与内存告警
• 自动更新：搭配 Watchtower（生产环境建议人工受控升级）

9. 常见故障速查

• 访问 502：
  • 检查 Caddy 服务状态：docker compose logs caddy
  • 确认域名解析指向当前 VPS IP
• Webhook 404：
  • 使用 Production URL（/webhook/ 路径），非 Test URL（/webhook-test/）
• 凭证丢失/无法解密：
  • 确认 N8N_ENCRYPTION_KEY 未被更改，更换后旧凭证将解密失败
• 连接 OpenAI/Claude 报错：
  • 确认 VPS 可直连目标 API 域名：curl 测试
  • 检查账号余额与限速设置

10. 为什么选这套架构

• 复杂度最低：仅两容器（n8n + Caddy），自动签发与续签 HTTPS
• 可维护性强：Docker Compose 一键启动/回滚，卷持久化保证数据安全
• 高稳定性：仅暴露 80/443；Swap 防峰值 OOM；易于平滑扩展至 Postgres/Redis

至此，您已掌握一套面向个人/小团队、HTTPS 与 Webhook 可靠、可直连海外 API 的 n8n 智能体基座。按上述步骤在搬瓦工 VPS 上即可快速部署与运行。