封面和插图放 GitHub 仓库,还是丢进 R2 的免费桶?

📚 静态博客部署选型系列

结论先放这儿

封面、插图一律放 Cloudflare R2,不要提交进 Git 仓库。

只有一种例外:网站的 Logo、favicon 这种「一共就几张、几十 KB、写完之后再也不会改」的小图,跟着源码走无所谓,没必要为它专门配一套图床。

其它情况——文章封面、截图、配图、示意图——只要你有长期写博客的打算,就别往 Git 里塞。

下面讲为什么。

理由一:免费额度里,「流出流量免费」这一条最值钱

R2 的免费额度(写这篇文章时):

  • 每月 10 GB 存储
  • 每月 100 万次 A 类操作(上传、列举)
  • 每月 1000 万次 B 类操作(读取)
  • 下行流量完全免费

最后一条是整个 Cloudflare 体系里最香的东西。

对比一下腾讯云 COS:存储便宜,但外网下行五毛一 GB,流量费才是账单的主要来源。而 R2 不管你的图片被刷多少次,流量费是零。

个人博客的真实体量是什么样?图片压成 WebP,单张几十 KB,10 GB 大概能装上万张。就算某篇文章被转到某个群里、短时间涌进一波访问,也不会突然冒出一笔流量账单。

「流量免费」这四个字,对个人站来说不是省钱,是消除不确定性。你不会因为一篇爆文而心疼。

理由二:Git 存二进制文件,是会一点点烂掉的

这是我最想强调的一点,也是很多人踩过才懂的。

Git 是为文本设计的。 它擅长记录「这行字改成了那行字」,每次提交只存差异。但图片是二进制,Git 没办法算差异,每次你改一次图、重新提交,它就在历史里存一份完整副本。

后果是这样的:

  • .git 目录越来越肥,而且是删不掉的肥。你把图片从仓库里删了、提交了,历史里的旧副本依然在。
  • git clone、git push 越来越慢;
  • Vercel / Pages 每次构建都要拉一遍完整仓库,构建时间跟着涨;
  • 仓库大到一定程度,GitHub 会开始限制,推送可能直接失败;
  • 想清理就得重写 Git 历史,然后所有本地克隆都得重新拉一遍——这个操作又危险又烦。

有人会说:用 Git LFS 啊。

是,LFS 能解决「大文件进历史」的问题,但免费额度很少,随便几十张高清图就可能用掉大半,还要额外配置、额外拉取。对一个只想写文章的人来说,这是给自己凭空加了一层复杂度。

一个博客仓库该装什么: _posts/*.md、主题配置、脚本、模板。全是文本,几 MB 顶天,几年都不会膨胀。这才是 Git 该待的地方。

理由三:链路统一,图床和主站吃同一套 CDN

R2 可以绑一个你自己的子域名(比如 img.yourdomain.com),然后走 Cloudflare 的 CDN 缓存。这意味着图片和网页在同一个网络体系里:

1
2
3
4
5
6
7
用户打开博客
↓
HTML/CSS/JS 来自 Pages(Cloudflare 网络)
↓
封面、插图请求打到 Cloudflare 边缘节点
↓
命中缓存 → 直接返回 R2 里的图

少一次跨厂商的 DNS 和建连,命中缓存的图片几乎和站内资源一个速度。而且以后你想换图床,也只需要改一个域名解析。

理由四:没有厂商锁定

R2 兼容 S3 API。这句话的实际含义是:以后你想迁到腾讯云 COS、EdgeOne、或者别家图床,用 rclone 之类的工具批量搬一遍就行,Markdown 里只需要批量替换图片 URL 前缀,正文一个字都不用改。

对比一下:如果图片散落在 Git 历史里,迁移的时候你要先把它们从历史里挖出来——那才叫麻烦。

理由五:关注点分离,构建更快

把两件事分开之后,整个工程清晰很多:

存哪 存什么 特点
GitHub Markdown、主题、配置、脚本 文本、可 diff、可回滚
R2 封面、插图、附件 二进制、走 CDN、不进版本库

构建的时候只打包页面,不打包一堆图片,构建产物体积小、速度也快。

但 R2 也不是没有缺点

一、国内访问同样是 Cloudflare 链路。

这一点必须说实话:R2 绑了 CF 的子域名,国内访问的体验和你博客主站是一样的——部分地区慢、偶尔打不开图。这不是 R2 的问题,是整个免费方案共同的短板。如果你的读者主要在国内,你迟早会面对这个取舍。

二、默认桶是私有的。

R2 的桶创建出来默认不公开,直接访问 URL 会 403。你必须手动开启公共访问、或者绑自定义域名,才能对外读。第一次配的时候容易卡在这里,别以为自己传失败了。

三、依赖 Cloudflare 账号。

如果你哪天决定彻底离开 CF 这套体系,图片要整体搬一次。不过因为兼容 S3,搬家本身不难。

我的工作流(Hexo + R2,不需要 PicGo)

实际跑起来是这样,不需要装 PicGo 这类工具:

  1. GitHub 仓库只放文本:_posts/*.md、主题配置、脚本、.gitignore 里把图片格式排除掉;
  2. 本地写文章,图片直接放到文章对应的同名文件夹里(Hexo 的 post_asset_folder 机制);
  3. 发布前跑一条脚本:先 hexo generate 生成页面,再用同步脚本把本地图片批量上传到 R2;
  4. Hexo 构建时自动替换路径:_config.yml 里配一个 cdn.image_prefix,构建脚本会自动把 Markdown 里的 ./xxx.png 替换成 https://img.yourdomain.com/文章slug/xxx.png,不需要手动改链接;
  5. git push → Pages 自动构建;
  6. 图片全部由 R2 + Cloudflare 边缘节点提供。

好处是:本地写、本地预览都有图,Git 仓库一样干净。代价是要维护一个上传脚本(可以用 Cloudflare 官方的 wrangler 命令行,不用写复杂代码)。

如果你担心「链接是外链,哪天图床挂了文章就废了」——那就在本地保留所有图片的原始文件,R2 只是分发用。这是任何自建图床都该做的备份习惯。

想搬家怎么办

把系列前面几篇的结论收一下,如果你哪天想从「免费方案」迁到「腾讯云 COS + 国内 CDN」:

  1. 域名做 ICP 备案(这是前置条件,绕不过);
  2. 静态页:public 同步上传到 COS 静态网站托管(用插件或 GitHub Actions 自动传);
  3. 图片:用 rclone 把 R2 桶整体同步到 COS,然后把 _config.yml 里的 cdn.image_prefix 改成 COS 的域名;
  4. 域名解析从 Cloudflare 橙云代理切到国内 CDN 的 CNAME;
  5. 配 CDN 缓存:HTML 短缓存、静态资源长缓存。

仓库不动、文章不动、写作流程不动。 这才是这套免费方案最让我放心的地方——它便宜,但它不锁人。

系列收尾

四篇写下来,其实就三句话:

  1. 国内稳定和零成本,现在是互斥的,先想清楚自己要哪个,再选方案;
  2. 免费方案能跑,但要接受国内访问的波动,并提前避开证书、缓存、流量额度这几个坑;
  3. 图片和文本分开放,Git 管 Markdown,R2 管图,两边都干净。

至于我,暂时就按这套跑着——等哪天访问量真的撑起来了,或者读者抱怨打不开了,再花钱买稳定。那时候要做的,只是把 public 换个地方上传而已。


封面和插图放 GitHub 仓库,还是丢进 R2 的免费桶?
https://www.kk218.com/posts/images-github-or-cloudflare-r2/
作者
KK218
发布于
2026年11月17日
许可协议