零成本全球博客容灾系统 —— 技术白皮书

版本：v1.0 | 日期：2026-06-18 | 状态：草案

摘要

本文档描述了一套基于纯免费平台的个人博客部署架构，通过 GitHub + Hugo + 三部署平台（Vercel/Netlify/Cloudflare Pages）+ R2 冷备份的组合，在不产生任何运行成本的前提下，实现跨平台容灾、自动构建部署、零数据丢失的博客系统。本架构不依赖自有域名，完全使用平台提供的免费二级域名。

1. 系统架构

1.1 顶层架构图

┌─────────────────────────────────────────────────────────────────┐
│                        内容生产层                                │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  本地编辑环境 (任意电脑)                                   │   │
│  │  Hugo CLI → Markdown 文章 → 本地预览 (localhost:1313)    │   │
│  │  git commit + git push → GitHub                          │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                               │ git push
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                        数据源层                                  │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  GitHub 公开仓库 (唯一事实来源，Single Source of Truth)   │   │
│  │  - 仅存储源码（Markdown + 配置 + 主题引用）              │   │
│  │  - 不存储构建产物 (public/ 在 .gitignore 中)            │   │
│  │  - 不存储依赖缓存                                        │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                    ┌──────────────┬──────────────┐
                    │              │              │
                    ▼              ▼              ▼
         ┌────────────────┐ ┌──────────┐ ┌──────────────────┐
         │  Vercel        │ │ Netlify  │ │ Cloudflare Pages │
         │  (部署站 A)    │ │ (部署站 B)│ │ (部署站 C)       │
         │                │ │          │ │                  │
         │ 自动: git hook │ │ 自动     │ │ 自动             │
         │ 手动: vercel   │ │ netlify  │ │ wrangler CLI     │
         │       deploy   │ │   deploy │ │                  │
         └────────────────┘ └──────────┘ └──────────────────┘
               │                  │               │
               ▼                  ▼               ▼
         ┌───────────────────────────────────────────┐
         │   用户访问入口 (无域名，直接使用平台域名)     │
         │                                           │
         │   blog.vercel.app    ← 主推地址            │
         │   blog.netlify.app   ← 备用地址 1          │
         │   blog.pages.dev     ← 备用地址 2          │
         └───────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                        冷备份层                                  │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  Cloudflare R2 (10GB 免费)                              │   │
│  │  - 存储 public/ 构建产物的压缩包                        │   │
│  │  - 核弹级恢复：仅当三平台 + GitHub 全挂时使用            │   │
│  │  - 启用 R2 静态托管可临时恢复访问                        │   │
│  └─────────────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  本地备份 (U盘/移动硬盘)                                  │   │
│  │  - public/ 的 zip 压缩包                                │   │
│  │  - 全量 git 仓库的克隆副本                               │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

1.2 数据流

[写文章] → Markdown 文件
    ↓
[hugo build] → public/ 目录 (HTML/CSS/JS/图片)
    ↓
[git push] → GitHub
    ↓ (webhook 触发)
[三平台各自构建] → hugo clone → build → public → serve
    ↓
[用户访问] → blog.vercel.app (或 备用地址)

1.3 关键设计决策

2. 故障模式与影响分析（FMEA）

2.1 故障总表

2.2 详细故障恢复程序

F-01: Vercel 宕机

现象: 访问 blog.vercel.app 返回 502/503/504 或超时 确认: 访问 https://www.vercel-status.com 确认状态 恢复操作:

1. 在博客首页/README 中标注备用地址: blog.netlify.app 或 blog.pages.dev
2. 用户手动切换到备用地址
3. 等 Vercel 恢复后自动可用

经验教训: 每次发布文章后，主动检查两个备用站是否同步构建成功

F-02: Vercel 取消免费计划（最危险的远期风险）

现象: Vercel 官方公告或邮件通知免费额度变更 确认: Vercel 官方博客 / Twitter / 邮件 恢复操作:

阶段 1（准备期）:
  └─ 在 Netlify 和 Cloudflare Pages 确认你的站点正常运行
  └─ 确认备用站可以承载所有流量

阶段 2（切换期）:
  └─ 选择 Netlify 作为新主站（或 Cloudflare Pages）
  └─ 更新所有对外链接指向新主站地址
  └─ 如有域名，DNS 改为指向新主站

阶段 3（整理期）:
  └─ 确认三平台仍有至少两个免费可用
  └─ 迁移构建配置中的 Vercel 特定设定

F-05: GitHub 被阻断

现象: git push 连接超时或 Failed to connect to github.com port 443 确认:

# 测试 GitHub 连通性
curl -I https://github.com --connect-timeout 5
# 如果长时间无响应或被 RST，说明被阻断

恢复操作（三种方案按优先级排列）:

方案 A: SSH 协议（优先尝试）
  1. git remote set-url origin git@github.com:用户名/仓库名.git
  2. 生成 SSH Key: ssh-keygen -t ed25519 -C "your@email.com"
  3. 添加到 GitHub: Settings → SSH and GPG keys
  4. 测试: ssh -T git@github.com

方案 B: 系统代理（如有代理）
  1. git config --global http.proxy http://127.0.0.1:7890
  2. git config --global https.proxy http://127.0.0.1:7890
  3. git push
  4. 推送完成后取消代理: git config --global --unset http.proxy

方案 C: 切换到 Gitee/GitLab（最彻底的备选）
  步骤 1: 在 gitee.com 注册并创建仓库
  步骤 2: 本地添加 remote:
    git remote add gitee https://gitee.com/用户名/仓库名.git
  步骤 3: 推送到 Gitee:
    git push -u gitee main
  步骤 4: 注意: Vercel/Netlify/CF Pages 需要重新关联新仓库
    └─ Vercel: Import 新仓库 → 重新部署
    └─ Netlify: New site → Import from Gitee
    └─ CF Pages: Create → Connect to Gitee
  ⚠️ 切换成本: 三平台需要重新配置构建参数和环境变量

F-09: 中国网络完全阻断境外 CDN

现象: Vercel/Netlify/Cloudflare Pages 三个域名在中国均无法访问 原因: 极端事件（大规模网络管控升级或海底光缆中断） 恢复操作:

方案 A: Cloudflare R2 托管（免费，零成本）
  1. 登录 Cloudflare → R2 → 创建存储桶
  2. 上传 public/ 内容
  3. 启用 R2 静态网站托管（免费）
  4. 获取 R2.dev 子域名访问地址
  5. 将此地址作为紧急访问入口
  ⚠️ 局限: R2 的国内速度取决于 Cloudflare 网络，可能仍受限

方案 B: 切换至国内平台（可能产生成本）
  1. 注册 EdgeOne Pages（腾讯云，有免费额度）
  2. 或注册阿里云 OSS + CDN（按量计费，极低流量几乎免费）
  3. 上传 public/ 内容
  4. ⚠️ 需要 ICP 备案（国内平台托管必须）
  5. ⚠️ ICP 备案需要国内服务器，纯静态托管不一定强制但有风险

方案 C: 纯离线分发（极端）
  1. 将博客 public/ 打包为 ZIP
  2. 通过网盘/邮件/IM 发给核心读者
  3. 等待网络恢复

2.3 平台免费额度明细

明确各平台的上限，防止超出后产生意外费用：

个人博客典型用量估算:

• 带宽：100 篇文章，每篇 500KB（含图片），月访问 1000 次 → 约 0.5 GB/月（远低于任何平台上限）
• 构建：每次 push 触发 3 次构建 × 每天 1 次 = 90 次/月（远低于 500 次上限）
• R2 存储：压缩包 ~50MB（远低于 10GB 上限）

结论: 个人博客在所有免费平台的容量上限面前都是「洒洒水」，不存在意外超限的可能性。

3. Plan B 分支全景图

零成本博客系统的核心保障不在于单一方案的完备性，而在于每一层都有退路。Plan B 不是一条备用路径，而是一个完整的分支树：

┌─ 本地编辑
│   ├─ Hugo 无法运行时 → Astro（Plan B-1a）
│   ├─ Hugo 主题报错   → 换主题（Plan B-1b）
│   └─ 电脑坏了        → 任意电脑 git clone（Plan B-1c）
│
├─ 代码托管
│   ├─ GitHub 被阻断    → SSH 协议 / 代理（Plan B-2a）
│   ├─ GitHub 完全不可用 → Gitee / GitLab（Plan B-2b）
│   └─ 推送失败        → 手动上传 CLI（Plan B-2c）
│
├─ 构建部署
│   ├─ Vercel 构建失败   → 本地构建手动上传（Plan B-3a）
│   ├─ Vercel 宕机      → 切换到 Netlify / CF Pages（Plan B-3b）
│   ├─ Vercel 取消免费   → Netlify 作为主站（Plan B-3c）
│   ├─ 三平台全部宕机    → R2 静态托管（Plan B-3d）
│   └─ 构建参数错误     → 锁定 Hugo 版本环境变量（Plan B-3e）
│
├─ 用户访问
│   ├─ 主站打不开       → 书签里找备用地址（Plan B-4a）
│   ├─ 不知道备用地址   → 博客页脚三平台链接（Plan B-4b）
│   └─ 中国完全阻断     → R2 / 国内网盘离线发布（Plan B-4c）
│
└─ 数据保全
    ├─ GitHub 仓库丢失   → 本地 U 盘恢复（Plan B-5a）
    ├─ 本地 + GitHub 丢失 → R2 备份恢复（Plan B-5b）
    └─ 所有线上数据丢失  → 即使全部丢失，历史文章 MD 文件在本地（Plan B-5c）

3.1 Plan B 详细条目

Plan B-1a: Hugo 无法运行 → 切换到 Astro

触发条件: Hugo 安装后运行报错无法解决、Hugo 社区逐渐式微 切换成本: 中（需要改目录结构 + 重写模板） 操作步骤:

# 1. 用 Astro 创建新站点
npm create astro@latest myblog-astro

# 2. 安装博客主题
npm install astro-theme-cactus

# 3. 将 content/ 目录下的 Markdown 复制过去（Hugo 和 Astro 的 Markdown 兼容）
cp -r ../hugo-project/content/posts ./src/content/blog/

# 4. 迁移 frontmatter 格式（Hugo 和 Astro 的差异很小，基本兼容）
# Hugo: --- title: "Hello" date: 2024-01-01 ---
# Astro: --- title: "Hello" pubDate: 2024-01-01 ---
# 只需要改 date → pubDate（如果主题要求）

# 5. 本地预览
npm run dev

# 6. git 推送到新仓库并重新关联三平台

Plan B-2b: GitHub 不可用 → Gitee 镜像

触发条件: GitHub 持续不通，代理和 SSH 均无效 切换成本: 中（三平台需要重新 Import） 操作步骤:

# 1. 注册 Gitee
# 2. 在 Gitee 创建同名仓库（设为公开）
# 3. 本地添加 remote
git remote add gitee https://gitee.com/用户名/仓库名.git

# 4. 推送
git push -u gitee main

# 5. 登录三平台，解除当前 GitHub 仓库绑定
#    Vercel: Project Settings → Git → Disconnect
#    Netlify: Site settings → Build & deploy → Repository → Disconnect
#    CF Pages: Project → Settings → Build configuration → Git → Disconnect

# 6. 重新 Import Gitee 仓库到三平台
#    ⚠️ 注意: Gitee 的 OAuth 集成不如 GitHub 完善，可能需要 Personal Access Token

Plan B-3a: CI 构建失败 → 本地构建 + 手动上传

触发条件: Vercel/Netlify/CF Pages 构建日志报错，自动修复无效 切换成本: 低（上传操作 5 分钟） 操作步骤:

# === Vercel CLI（需要安装）===
# 安装 Vercel CLI
npm install -g vercel

# 本地构建
cd myblog
hugo

# 直接部署 public/ 目录
vercel deploy --prebuilt --prod ./public

# === Netlify CLI ===
# 安装 Netlify CLI
npm install -g netlify-cli

# 本地构建 & 部署
netlify deploy --prod --dir=public

# === Cloudflare Wrangler CLI ===
# 安装
npm install -g wrangler

# 部署
npx wrangler pages deploy public --project-name=myblog

这个方案的意义: 即使 CI 系统全部坏了，你仍然可以在 5 分钟内手动推送静态文件上线。

Plan B-3d: 三平台全部宕机 → R2 静态托管

触发条件: Vercel + Netlify + Cloudflare Pages 同时无法访问 恢复操作:

# 1. 登录 Cloudflare → R2 → 创建存储桶（如 myblog-emergency）

# 2. 手动上传 public/ 到 R2（使用 Wrangler CLI 或网页上传）
npx wrangler r2 object put myblog-emergency/index.html --file=public/index.html

# 3. 在存储桶设置中启用静态网站托管
#    Settings → Public Access → Allow public access
#    记下端点 URL（如 https://pub-xxxxxxxxxxxxx.r2.dev）

# 4. 将此地址作为紧急入口发布

Plan B-4c: 中国彻底阻断境外 CDN → 离线分发

触发条件: Vercel/Netlify/CF Pages 在中国全部无法访问 恢复操作:

# 方案 A: 通过国内网盘
# 将 public/ 打包上传到 阿里云盘 / 百度网盘 / 腾讯微云
# 在社交账号上分享链接

# 方案 B: 国内对象存储（需备案，但成本极低）
# 注册阿里云 OSS → Bucket 设置为静态托管 → 上传 public/
# 费用：OSS 按量计费，个人博客 ~0.1 元/月

# 方案 C: 纯离线
# 生成 single-page PDF 版本（hugo 无此功能，需 pandoc 转换）

Plan B-5a: 从 U 盘恢复

触发条件: 所有线上数据丢失，本地有 U 盘备份 恢复操作:

# 1. 从 U 盘拷贝博客源码到新电脑
# 2. 安装 Hugo（如果需要）
# 3. 重新关联 GitHub
git remote add origin https://github.com/用户名/仓库名.git
git push -u origin main
# 4. 三平台因 GitHub 仓库更新自动重新构建
# 5. 恢复完毕

4. 安全性与隐私考虑

4.1 公开仓库的隐私保护

GitHub 公开仓库意味着所有人都可以看到你的代码仓库。需要注意：

4.2 平台账户安全

4.3 内容备份安全

5. 成本分析

6. 限制与已知问题

7. 长期维护计划

本文档是活文档，随系统演进持续更新。