GH-ImgBed —— 用 GitHub 存图 + Cloudflare 边缘分发，零成本自建图床

🏗️ 整体架构#

浏览器从头到尾只跟 Cloudflare 边缘节点通信，回源由服务端完成。

关键点：访客所在网络能否直连 GitHub，并不影响访问 —— 回源这一步发生在服务端。

🔄 上传与访问时序#

文件名格式是 YYMMDD-5位随机.扩展名，例如 261010-k7f2m.png。5 位随机空间约 6000 万，撞名概率极低，代码里仍保留了最多 6 次的换名重试。

🚀 部署流程#

✨ 功能特性#

⚙️ 环境变量#

1
const TURNSTILE_SITEKEY = "0x4AAAAAAFUKaXfCncBNv71l"; // ← 换成你自己的

🔐 人机验证（可选）#

防止脚本批量刷上传接口，基于 Cloudflare Turnstile。只保护上传，不保护 /v2/ —— 那是出图用的，加了验证图就无法外链了。

1
第 1 张    ──带 token──> siteverify ──通过──> 签发 HMAC 凭证（10 分钟）
2
第 2..N 张 ──带凭证──> 校验签名与有效期 ──通过──> 写入 GitHub

📁 目录结构#

1
index.html                  页面结构
2
assets/app.css              样式：设计令牌、深浅主题、响应式
3
assets/app.js               逻辑：上传、列表、复制、二维码、主题
4
                            └─ 含 TURNSTILE_SITEKEY，启用验证前须换成自己的
5
assets/fonts.css            Material Icons 字体声明（本地）
6
assets/fonts/*.woff2        Material Icons 字体文件
7
functions/upload.js         上传：写入 GitHub
8
functions/v2/[[vkey]].js   访问：回源 + 边缘缓存
9
scripts/verify_upload.py    部署前自检脚本

图标字体是本地自托管的，不引用 fonts.googleapis.com（该域名在中国大陆不可访问）。字体名须与 mdui 期望的完全一致，且需开启 font-feature-settings: 'liga'，否则连字不生效、图标会显示为文字。

assets/app.js 里的 CONCURRENCY 控制同时上传的数量，默认 1（串行）。多选图片时若并发过高，Cloudflare Functions 需同时做多次 base64 编码，可能超出免费额度的 CPU / 内存限制而被中断。除非确认额度充足，否则不建议调大。

✅ 部署前自检#

1
export GITHUB_TOKEN='github_pat_xxx'
2
export GITHUB_OWNER='你的用户名'
3
export GITHUB_REPO='你的仓库'
4
python3 scripts/verify_upload.py

脚本会依次检查令牌有效性、仓库可访问性、写入权限、链接可访问性，并自动清理测试文件。

🔧 日常维护#

1
curl -X DELETE \
2
  -H "Authorization: Bearer $GITHUB_TOKEN" \
3
  -H "Accept: application/vnd.github+json" \
4
  https://api.github.com/repos/<owner>/<repo>/contents/<path> \
5
  -d '{"message":"delete","sha":"<上传时返回的 sha>","branch":"images"}'

❓ 常见问题#

上传返回 403 — 令牌缺 Contents: Read and write，或 Repository access 没包含该仓库。

上传返回 422 — 通常是同名文件冲突，代码会自动换名重试 6 次；若仍失败，检查分支是否存在。

多选上传时部分失败，提示「网络错误」 — 同时上传太多图片会让 Functions 并发做多次 base64 编码，可能超出免费额度的 CPU / 内存限制而被中断。默认已串行（CONCURRENCY = 1），若仍失败就一次少选几张。

图片上传了但打不开 — 确认 images 分支存在且文件确实写入。访问代理回源的是 raw.githubusercontent.com/<owner>/<repo>/images/<path>。

刷新后上传历史没了 — 历史存在浏览器 localStorage，按域名隔离。换了域名后旧记录读不到，这是浏览器行为，不是故障。

图标显示为 cloud_upload 这样的英文 — Material Icons 字体没加载。确认 assets/fonts/*.woff2 能访问，且字体名与 mdui 期望的一致。

⚠️ 已知限制#

🛠️ 技术栈#

📄 许可#

MIT License — 可自由使用、修改和分发