GH-ImgBed

工作原理#

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

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

为什么不用现成图床#

第三方图床要么有「X 个月未访问自动删除」，要么哪天就关停了。图片存在自己仓库里，数据在自己手上，链接也不会因为服务跑路而失效。

特性#

• 数据自主 — 图片存在自己的 GitHub 仓库，不依赖任何第三方图床服务
• 不会过期 — 没有「X 个月未访问自动删除」的策略
• 可以删除 — 上传响应返回 sha，可精确删除单个文件
• 仓库可私有 — 访问代理携带令牌回源，代码无需开源
• 边缘缓存 — Cloudflare Cache API 确定性缓存，首次访问即生效
• 链接与后端解耦 — 访问统一走 /v2/ 代理，日后换存储或 CDN，老链接不用改
• 免域名 — 可用 *.pages.dev，也支持绑定自己的域名

使用体验#

• 点击 / 拖拽 / 粘贴上传，支持多选
• 每条结果可：复制链接、复制 Markdown、查看二维码、打开原图、移除
• 一键复制全部链接或全部 Markdown
• 上传历史存 localStorage，刷新后仍在
• 深浅主题切换（未选择时跟随系统，首屏无闪烁）
• 小屏适配：安全区、44px 触控目标、响应式布局

快速开始#

1
git switch --orphan images
2
git rm -rf .
3
echo "# 图库" > README.md
4
git add README.md
5
git commit -m "init: 图片存储分支"
6
git push -u origin images

部署前自检#

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

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

已知限制#

技术栈#

许可#

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