PicGo GitHub Config
PicGo GitHub 图床搭建
📝 笔记总结
以下可以不用看，我已经卸载 PicGo。我现在使用的是直接保存图片，上传到 GitHub 仓库，然后通过链接地址引用。
例如：
https://cdn.jsdelivr.net/gh/用户名/仓库名@分支名/文件夹/图片名
或：
https://raw.githubusercontent.com/用户名/仓库名/分支名/图片名
之前的文章：GitHub raw vs cdn
当然也可以使用 PicGo 进行 GitHub 图床设置。
📖 内容来源
使用 PicGo + GitHub 图床，是一种很流行的免费方案，特别适合写博客、记笔记时管理图片。本质上是让 PicGo 这个工具，把你本地的图片自动上传到 GitHub 仓库，并生成一个在线的图片链接。
🔧 创建 GitHub 仓库与 Token
首先需要在 GitHub 上创建一个用来存放图片的“图床仓库”，并生成一个访问令牌 (Token)，这是 PicGo 上传图片的“钥匙”。
1. 创建公开仓库
在 GitHub 点击右上角 + 号，选择 New repository。注意：仓库的可见性必须选 Public，否则图片无法被公开访问。
2. 生成 Token
点击头像 → Settings → 左下角 Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic)。
* Note (名称)：随便填一个，比如 PicGo-image。
* Expiration (过期时间)：建议选 No expiration（永不过期），不然过期后需要重新生成并更新配置。
* Select scopes (权限)：务必勾选 repo 这个选项，这会赋予 PicGo 读写你仓库的权限。
* 点击生成后，立即复制并妥善保存这个 Token（它只显示一次）。
⚙️ 配置 PicGo
下载安装 PicGo 后，在“图床设置”里找到 GitHub 进行配置。
| 配置项 | 填写内容 | 备注 |
|---|---|---|
| 设定仓库名 | 你的GitHub用户名/仓库名 |
例如：zhangsan/my-image-bed |
| 设定分支名 | main |
2020年后GitHub新仓库默认分支为main |
| 设定Token | 粘贴刚才保存的Token | |
| 指定存储路径 | img/ (选填) |
图片将上传到仓库下的img文件夹，不填则传至根目录 |
| 设定自定义域名 | https://cdn.jsdelivr.net/gh/你的用户名/仓库名@main |
这是最关键的一步，使用jsDelivr CDN加速访问，国内访问更快 |
小提示：如果上传成功后图片无法显示，大概率是“自定义域名”配置有误。可以尝试将域名改为
https://raw.githubusercontent.com/你的用户名/仓库名/main测试。
✍️ 与 Typora 集成（可选）
如果你用 Typora 写 Markdown，可以配置它调用 PicGo 实现“粘贴即上传”：
- 打开 Typora，进入
文件→偏好设置→图像。 - 插入图片时：选择
上传图片。 - 上传服务：选择
PicGo (app)，并指定你 PicGo 的安装路径。 - 点击“验证图片上传选项”，成功后就可以在 Typora 里愉快地粘贴图片了。
⚠️ 常见问题与排错
- Token 过期：这是最容易被忽略的问题。如果之前能用，突然有一天上传失败，可以先检查一下你的 GitHub Token 是否已过期。建议生成时直接选
No expiration。 - 端口占用：PicGo 默认监听端口是
36677，如果同时开启了多个 PicGo 进程或其他加速工具（如 Steam++），可能会冲突，导致上传失败。 - 网络与 Hosts：由于 GitHub 服务器在国外，网络波动可能影响访问。如果上传很慢或失败，可以尝试修改 Hosts 文件，将
raw.githubusercontent.com等域名指向可用 IP。