使用 PicGo + GitHub + Cloudflare 搭建稳定图床#

1. 打开 Token 创建入口#

• GitHub → 右上角头像 → Settings
• 左侧菜单 → Developer settings
• 选择：Personal access tokens → Fine-grained tokens
• 点击右侧按钮：Generate new token

2. 配置 Token 基本信息#

• Token name：PicGoUploadToken
• Expiration：建议设置较长时间（安全起见可设置 90 天或 1 年）。
• Resource owner：选择你的 GitHub 账号
• Repository access：选择 Only select repositories，并勾选你的图床仓库（例如 myImage）

3. 配置权限#

关键

找到 Permissions 区域，在 Repository permissions 中 只启用两个权限：

权限项	选择
Contents	Read and write
Metadata	Read-only（默认即可）

PicGo 上传图片只需要写入仓库内容，不需要其他敏感权限。

4. 生成 Token#

滚动到页面底部 → 点击 Generate token

GitHub 会生成一段以 github_pat_ 开头的 Token（生成后复制，只显示一次），例如：

github_pat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. 新建 Cloudflare Pages 项目#

• 在 Cloudflare 控制台：
• 左侧菜单：Workers 和 Pages
• 创建应用程序

• 选择 Connect GitHub

• 选择底部的 Get started

• 导入现有 GitHub 仓库
• 绑定一个仓库（我这里绑定的是刚刚新建在 GitHub 的 myImage 仓库）

• 维持默认配置后，保存并部署

2. 创建静态代理 Functions#

GitHub 仓库文件配置

在绑定的仓库根目录下创建/functions/gh文件夹，文件夹下创建文件[[path]].js，填入以下内容：

1
export async function onRequest(context) {
2
  // [[path]] 对应的参数名就是 path，这里会是一个数组
3
  const segments = context.params.path || [];
4
  const path = segments.join("/");
5

6
  // 组装成 GitHub Raw 地址
7
  const url = `https://raw.githubusercontent.com/${path}`;
8

9
  const res = await fetch(url, {
10
    headers: {
11
      "User-Agent": "Mozilla/5.0"
12
    }
13
  });
14

15
  return new Response(res.body, {
16
    headers: {
17
      "Content-Type": res.headers.get("Content-Type") || "application/octet-stream",
18
      "Cache-Control": "public, max-age=31536000"
19
    },
20
    status: res.status
21
  });
22
}

Cloudflare 会自动缓存资源。

3. 部署 Cloudflare Pages#

部署完成后 Cloudflare 会生成默认域名，例如：

https://your-project.pages.dev

配置使用自定义域名（可选）

例如：

https://img.xhwen.cn

添加一条 CNAME 解析到 Cloudflare Pages 就行。

4. 最终 CDN URL 格式#

将图片从 GitHub 映射到 Cloudflare：

https://myimage-9r1.pages.dev/gh/<用户名>/<仓库名>/<分支名>/<路径>/<图片文件名>

https://myimage-9r1.pages.dev/gh/xiaowenmimimi/myImage/main/img/blog/sample_pictures.jpg

PicGo 配置修改

在 PicGo 的 GitHub 图床设置中，将 自定义域名 修改为：

https://myimage-9r1.pages.dev/gh/<用户名>/<仓库名>/<分支名>

例如：

https://img.xhwen.cn/gh/xiaowenmimimi/myImage/main

PicGo 上传后生成的 URL 自动使用 Cloudflare CDN 链接。