极致优雅的开源图床解决方案。集成 Typora + PicGo + GitHub Actions + 微信公众号同步。 别再手动压缩和搬运图片了，让流水线为你打理一切。
English | 中文说明
本项目文档及更多相关工具已整合至统一域名：
graph LR
A[Typora 粘贴] --> B[PicGo 上传 GitHub]
B --> C{GitHub Action}
C --> D[Job 1: 瞬时 CDN 预热]
C --> E[Job 2: 差异化压缩]
E --> F[Git Commit 回传]
E --> G[同步微信素材库]
作为博主或开发者，你是否厌倦了以下流程？
- ❌ 图片太大：手动压缩太累，不压缩 CDN 流量费太贵。
- ❌ 同步繁琐：GitHub 上传了，还得手动去微信公众号后台再传一遍。
- ❌ 访问慢：GitHub Raw 访问不稳定，CDN 预热全靠手动刷新。
- ❌ IP 限制：微信 API 有 IP 白名单，GitHub Actions 的动态 IP 根本没法用。
Blog Images Box 专为解决这些问题而生！🚀
- ⚡ 快慢路径并行 Job：CDN 预热 (Fast) 与 压缩同步 (Background) 并行，提速 200%。
- 📦 Typora + PicGo 集成：本地截图，一键粘贴，GitHub 自动处理。
- 📉 智能增量压缩：使用
jpegoptim/optipng，仅针对新增图片，大小立减 60%+。 - 📲 公众号自动化同步：通过中转服务器彻底绕过微信 IP 白名单限制。
- 🛡️ 安全隔离架构：支持
github-bot专用账户，免除腾讯云异地登录告警，保护 root 安全。 - 🔄 幂等同步 (Registry)：内置 MD5 校验，避免重复上传，节省微信素材空间。
- 📁 每日壁纸存档：自动抓取 Bing/Unsplash 每日壁纸。
.
├── .github/workflows/ # 🚀 高级并行流水线
├── blog/ # 📷 博客图片存储 (Typora 默认路径)
├── wallpapers/ # 🎨 每日壁纸存档
├── scripts/ # 🐍 核心同步脚本 (Python)
└── docs/ # 📄 GitHub Pages 静态文档
- Fork 本仓库。
- 配置 Typora + PicGo (GitHub 插件)，将上传地址指向您的仓库。
在 Settings -> Secrets -> Actions 中添加：
| Secret 名称 | 含义 | 说明 |
|---|---|---|
CDN_DOMAIN |
CDN 域名 | 如 img.example.com |
WECHAT_APP_ID |
微信 AppID | 公众号后台查看 |
WECHAT_APP_SECRET |
微信 AppSecret | 公众号后台查看 |
SERVER_HOST |
中转服务器 IP | 您的托管服务器公网 IP |
SERVER_USER |
SSH 用户 | 强烈建议使用 github-bot |
SERVER_KEY |
SSH 私钥 | 私有密钥内容 |
⚠️ 重要提示 (微信白名单)： 您必须前往 [微信公众平台] -> 设置与开发 -> 基本配置 -> IP白名单，将您的中转服务器公网 IP（即SERVER_HOST）加入白名单。否则同步脚本将无法获取 Access Token。
为了避免 GitHub Actions 全球节点连接您的腾讯云服务器触发“异地登录告警”，建议执行以下操作：
- 新建专用账户：
# 在服务器执行 adduser github-bot - 权限限制：
将该用户限制在只能操作
~/blog-sync目录。 - 部署密钥：
按照下方“密钥教程”将公钥部署给
github-bot用户。 - 腾讯云白名单：
在腾讯云主机安全后台，对
github-bot用户免除异地登录告警。即使 IP 来自美国或新加坡，由于是指定用户且仅限特定目录，系统将不再频繁误报。
- 生成 PEM 格式密钥 (兼容性最高)：
ssh-keygen -t rsa -b 4096 -m PEM -f ./id_rsa_github -N "" - 部署公钥：
ssh-copy-id -i ./id_rsa_github.pub github-bot@您的服务器IP
- 本地验证：
ssh -i ./id_rsa_github github-bot@您的服务器IP
GitHub Raw 的访问在某些地区不够稳定。通过 Cloudflare Worker，您可以将其转换为一个支持全球 CDN 缓存、免备案、且支持自定义域名的超强图床网关。
- 登录 Cloudflare 控制台，进入 Workers & Pages。
- 点击 Create application -> Create Worker。
- 命名为
blog-images-proxy并在编辑器中粘贴本项目提供的加速代码。
将以下代码中的变量修改为您自己的信息：
const GITHUB_USER = 'hana19951208';
const GITHUB_REPO = 'BlogImagesBox';
const GITHUB_BRANCH = 'main';
export default {
async fetch(request, env) {
const url = new URL(request.url);
const path = url.pathname;
const githubUrl = `https://raw.githubusercontent.com/${GITHUB_USER}/${GITHUB_REPO}/${GITHUB_BRANCH}${path}`;
let response = await fetch(githubUrl, {
headers: { 'User-Agent': 'Cloudflare-Worker' }
});
if (response.status === 200) {
let newHeaders = new Headers(response.headers);
newHeaders.delete("Vary");
newHeaders.delete("X-Frame-Options");
newHeaders.delete("Content-Security-Policy");
// 强制缓存 1 年，加速访问
newHeaders.set("Cache-Control", "public, max-age=31536000, s-maxage=31536000, immutable");
newHeaders.set("access-control-allow-origin", "*");
return new Response(response.body, { status: 200, headers: newHeaders });
}
return response;
}
}- 在 Worker 详情页点击 Settings -> Triggers -> Custom Domains。
- 添加您的域名（如
img.fangenwu.cn）。 - 注意：由于腾讯云域名实名审核中，Cloudflare 可能会提示 DNS 挂载问题，请确保您的域名服务器已指向 Cloudflare。
- 在 PicGo 中选择 GitHub 图床。
- 设定自定义域名：填写您的 Cloudflare Worker 域名（例如
https://img.fangenwu.cn）。 - 这样您在 Typora 中粘贴图片时，PicGo 会将其上传到 GitHub，同时返回通过 Cloudflare 加速后的地址。
- 支持更多中转协议 (如 HTTP Proxy)。
- 增加图片水印自动添加功能。
- 支持阿里云 OSS / 腾讯云 COS 同步。
Proudly powered by GitHub Actions & Cloudflare. If you like it, please give a ⭐️!