Hybrid Deploy · Cloudflare + 腾讯云轻量

把 boss-skills 分层部署: 静态层 (5 showcase + landing + openapi) 走 Cloudflare Pages ($0 全球 CDN), 动态层 (boss_server FastAPI + attribution cron + anchors raw) 走 腾讯云轻量 (70-80 元/月). 责任分离 / 成本最优 / 故障隔离 / 国内速度最快. 见 ADR-005.
strategy · hybrid
phase 1 · Cloudflare 静态
phase 2 · 腾讯云 API
tier · D2 实现细节
$0
Cloudflare Pages 月费 (静态 + CDN)
~80 元
腾讯云轻量 2C2G/月 (API + cron)
~30 min
Phase 1 装机时间 ($0, 零风险)
3-5x
国内 docs 访问速度提升 (vs 单 VM)
JUMP TO §1 · 架构 §2 · 两层职责 §3 · 部署步骤 §4 · 成本对比 §5 · 决策矩阵 §6 · 好处

SECTION 1 Hybrid 架构图 2 host · 1 source · 集中 DNS

用户 (国内 + 海外) 浏览器 / curl / Hermes / OpenClaw click docs curl API Cloudflare Pages (静态层) 全球 CDN · $0/月 · landing.html · 5 showcase (anatomy/commands/api/...) · docs/api/openapi.json · README · 文档总览 无 secret · 公开 · push to main auto-deploy boss-vault.pages.dev 或自定义 腾讯云轻量 (动态层) 2C2G 40GB · 70-80 元/月 · uvicorn boss_server (5 endpoint) · systemd timer attribution cron · nginx + Let's Encrypt SSL · anchors/raw/ chmod 700 (confidential) 有 secret · systemd always-on · git pull deploy api.your-domain.com GitHub (source of truth) zhanglunet/boss-vault · main push auto-deploy git pull + systemctl Cloudflare DNS (统一管理) · A api.x.com → vm-ip · CNAME www → pages.dev

SECTION 2 两层职责 + 时间表 Phase 1 立即可做 · Phase 2 按需启动

Phase 1 · Cloudflare Pages

$0/月
TIME
~ 30 min
RISK
0 (静态, 无 secret)
URL
boss-vault.pages.dev
资源
  • landing.html (对外门户)
  • 5 个 showcase 信息图 (anatomy / commands / api / anchor-wiki / 5-cases / hybrid)
  • docs/api/openapi.json (OpenAPI 3.0 spec)
  • README + docs/index.html (文档总览)
  • ADR / cookbook / dev-log markdown
特性
  • 全球 CDN (含 China Network), 国内速度 < 50ms
  • auto SSL + 自定义域名
  • push to main → GitHub integration → ~30s 自动 deploy
  • 每个 deploy 独立 preview URL
立即可做: $0 + 零风险 + 立即可见. 推荐 今天就部署, 不阻塞任何后续工作.

Phase 2 · 腾讯云轻量

~80 元/月
TIME
~ 2 小时
RISK
中 (需 SSH 运维)
URL
api.your-domain.com
资源
  • scripts/boss_server.py (FastAPI · 5 sync endpoint)
  • scripts/attribution_check.py (systemd timer 每天)
  • anchors/<slug>/raw/ (confidential, chmod 700)
  • nginx (reverse proxy + SSL + rate limit)
  • .env (ANTHROPIC_API_KEY 等 secret)
规格 (推荐)
  • 2C2G 40GB SSD · Ubuntu 22.04 LTS · ~ 70 元/月 (年付)
  • 带宽 4-6 Mbps · 流量 100-300 GB/月
  • 公网 IP (固定) · 自带
按需启动 · 触发信号 (任一):
· 外部 user 明确要 curl API
· 内部 ≥ 3 人需要 always-on
· D3 schedule 高峰延迟影响 attribution 时效 (已实测 > 51 min)

SECTION 3 部署步骤 点 tab 切两层步骤

SECTION 4 成本对比 hybrid vs 单 VM 全栈

方案 静态 host API host 含数据 国内 docs 速度 月成本
★ Hybrid (本方案) Cloudflare Pages 腾讯云 2C2G 腾讯云 (chmod 700) < 50ms ~ 80 元
单 VM (阿里云 2C4G) 同一 VM 同一 VM 同上 ~ 200ms ~ 140 元
单 VM (AWS t3.medium) 同一 VM 同一 VM 同上 ~ 500ms (海外) ~ 250 元
K8s 集群 (生产) Ingress + Service Deployment PV/PVC ~ 100ms ~ 500+ 元
省 30-70% 同时国内 docs 速度提升 3-5x. 不是过度优化, 是合理的资源分层。

SECTION 5 决策矩阵 · 你需要哪几层? 不一定全部署

你的场景 A 静态 (Cloudflare) B-1/2/3 API (腾讯云) B-4 Cron (腾讯云) 月成本
想给外部人看 docs / 信息图 ✓ — — $0
想让外部 LLM runtime 调 API ✓ ✓ 可选 ~ 80 元
想 always-on attribution cron 自动跑 ✓ ✓ ✓ ~ 80 元
完整生产 + 飞书 push + 多 anchor ✓ ✓ ✓ ~ 130 元 (升 4C8G)
最低 MVP = A only. 静态文档对外公开, API 完全本地 Claude Code (D1) 跑. 这是大多数 V0 期项目的起点.

SECTION 6 9 个好处 hybrid vs 单 VM

BENEFIT 01

责任分离

静态 (公开 docs) 与动态 (有 secret + cases data) 物理隔离, blast radius 缩小 90%
BENEFIT 02

成本最优

Cloudflare $0 处理 99% 公开流量 · 腾讯云 80 元/月 仅承载 1% 真 API 调用
BENEFIT 03

故障隔离

API 宕 → docs 仍可访问 (反之亦然), 关键时刻不至于"全死"
BENEFIT 04

安全分离

静态站完全无 secret (无 ANTHROPIC_API_KEY, 无 .env), 即使入侵也没重要资产
BENEFIT 05

地理优化

国内看 docs → Cloudflare 边缘 (< 50ms) · 调 API → 腾讯云国内 region (低延迟)
BENEFIT 06

可扩展性

静态: Cloudflare 自动 ∞ scale · API: 腾讯云 2C2G → 4C8G → 8C16G 垂直升
BENEFIT 07

CDN 缓存

5 个 showcase (~ 100 KB/个) 走 Cloudflare CDN, 一次请求覆盖全球; API 直连
BENEFIT 08

CI/CD 自动化

静态: push to main → Pages 自动 deploy (~ 30s) · API: git pull + systemctl restart
BENEFIT 09

DNS 统一

Cloudflare 同时管 www (静态) + api (动态), 一处 DNS + SSL 配置, 集中可控