当前位置：首页 > news >正文

使用 PicGo 与 GitHub 搭建高效图床，并结合 Local Images Plus 备份原图

news 2025/8/9 11:57:09

在技术写作、博客创作和文档编写中，插入清晰、美观且可长期访问的图片是必不可少的。
然而，将图片直接上传到博客平台往往存在以下问题：

为了解决这些问题，越来越多开发者选择自建图床（Image Hosting）。
PicGo + GitHub 的组合，正是一个免费、跨平台且简单高效的方案：

此外，在日常写作中，我还额外下载了 Local Images Plus 插件，目的是在上传到图床的同时，在本地保留一份原图。
这样无论将来发布到不同的博客平台，还是迁移内容，都能有原始图片的备份，避免图床失效或丢失造成的内容缺失。

仓库名：[GitHub用户名]/[仓库名]
分支：main（注意：自 2020 年 10 月起，GitHub 默认分支名从 master 改为 main）
设定 Token：粘贴刚生成的 GitHub Token
存储路径（可选）：如填 img，则图片将保存在 img 文件夹下
自定义域名（推荐 CDN 加速）：
```
https://cdn.jsdelivr.net/gh/[GitHub用户名]/[仓库名]@main
```
⚠️ 如果不指定 @main，PicGo 默认会用 master，导致上传后图片无法访问

配置完成后，就可以直接在 PicGo 上传区测试图片上传。

虽然 PicGo 上传到图床后，笔记中会有一个可用的外链，但为了长期内容安全，建议本地也保留一份原图。
我下载 Local Images Plus 插件，正是为此目的：

插件作用
- 自动检测笔记中的远程图片链接（如 PicGo 生成的图床 URL）。
- 自动下载到本地指定的附件文件夹（如 attachments/）。
- 自动替换为本地相对路径，确保离线也能查看。
推荐配置
- Save folder：设为 vault 内的 attachments 文件夹。
- Automatic processing：开启（粘贴或插入时立即下载并替换）。
- Replace links：开启（确保链接替换为本地路径）。
- （可选）Convert PNG to JPEG：节省空间，可设画质 80–90%。
实战流程
- 粘贴截图 → PicGo 上传到 GitHub 图床 → 笔记插入 URL。
- Local Images Plus 检测到 URL → 自动下载到 attachments → 替换为本地路径。
- 结果：图床有一份，vault 本地也有一份，可随笔记备份。
批量处理历史笔记
- 命令面板运行 Localize attachments for the current note（当前笔记）或 Localize attachments for all your notes（整个库，需先备份）。

为什么不用 GitHub 原生链接？
原生链接格式为：
```
https://raw.githubusercontent.com/[username]/[repo]/[branch]/[path]
```
但访问速度往往很慢。使用 jsDelivr 作为 CDN 加速，只需更改域名即可，无需额外配置。
上传失败怎么办？
多数情况下是某一步配置有误。像调试代码一样，逐项检查：
- 仓库名拼写是否正确
- 分支是否为 main
- Token 是否有效且权限足够
- PicGo 中的路径和域名是否一致