GitHub+PicGo 图床搭建全流程教程
一、图床相关介绍
1. 什么是图床
图床是一种专注于图片存储与分发的在线服务,核心功能是:
用户上传本地图片至云端服务器后,系统自动生成可直接访问的图片链接。通过该链接,用户可在任意平台(如博客、文档、社交软件)引用图片,无需关心图片的存储位置和带宽消耗。
2. 图床能解决的问题
- 存储问题:为个人用户或小型网站提供低成本(甚至免费)的图片存储方案,避免占用自有服务器空间和带宽。
- 分享问题:统一图片访问链接,解决本地图片在不同设备/平台间传输的繁琐性。
- 管理问题:多数图床支持图片分类、标签标注等管理功能,便于批量查找和复用。
- 性能问题:依托CDN(内容分发网络)加速,提升全球各地用户的图片加载速度。
- 安全性问题:部分图床提供防盗链、访问权限设置等功能,保护图片不被非法盗用。
二、在GitHub上创建图床
1. 解决GitHub访问速度慢的问题
推荐使用 Watt Toolkit(原Steam++)优化访问速度:
- 下载并安装工具后,启动程序并勾选「GitHub加速」选项,无需额外配置即可生效。
2. 创建仓库
- 登录GitHub账号(无账号需先注册)。
- 点击右上角「+」图标,选择「New repository」。
填写仓库信息:
- 仓库名称:建议使用
img-bed、picture-storage等直观名称。 - 仓库描述:可选填(如「个人图片存储仓库」)。
- 可见性:选择「Public」(公开仓库可通过CDN加速访问)。
- 仓库名称:建议使用
- 点击「Create repository」完成创建。
3. 生成token令牌(关键步骤)
- 点击右上角头像,选择「Settings」进入设置页面。
- 在左侧菜单中依次展开:「Developer settings」→「Personal access tokens」→「Tokens (classic)」。
- 点击「Generate new token」→「Generate new token (classic)」。
配置令牌参数:
- Note:填写令牌用途(如「PicGo图床访问权限」)。
- Expiration:选择令牌有效期(建议选「No expiration」避免频繁更新)。
- Scopes:勾选「repo」权限(获取仓库读写权限)。
- 点击「Generate token」生成令牌,立即复制并保存到本地文档(令牌仅显示一次,丢失需重新生成)。
三、PicGo相关操作
1. PicGo介绍
PicGo是一款开源免费的图片上传工具,支持GitHub、阿里云OSS、腾讯云COS等多种图床,核心优势:
- 支持拖拽上传、剪贴板图片上传等快捷操作。
- 自动生成Markdown、HTML等格式的图片链接。
- 可配置默认图床,实现「一键上传」。
2. 下载与安装
- 官方下载地址:PicGo GitHub Release
- 选择对应系统版本(Windows用户选
.exe,macOS用户选.dmg),下载后双击安装即可。
3. 配置GitHub图床(核心步骤)
- 打开PicGo软件,点击左侧「图床设置」,选择「GitHub图床」。
填写配置参数:
- 仓库名:格式为「GitHub用户名/仓库名」(如
yourname/img-bed)。 - 分支名:填写仓库默认分支(通常为
main或master)。 - Token:粘贴第二步中保存的GitHub令牌。
- 存储路径:可选填(如
2024/,表示图片按年分类存储)。 - 自定义域名:填写CDN加速地址,格式为
https://cdn.jsdelivr.net/gh/用户名/仓库名@分支名
(示例:https://cdn.jsdelivr.net/gh/yourname/img-bed@main)。
- 仓库名:格式为「GitHub用户名/仓库名」(如
- 点击「确定」保存配置,建议勾选「设为默认图床」。
4. 常见错误解决
| 问题现象 | 解决方法 |
|---|---|
| 报错“Error: ENOENT: no such file or directory, open...picgo.log” | 打开文件管理器,输入路径%APPDATA%\picgo,删除data.json文件后重启软件(建议先备份)。 |
| 双击图标无反应,但后台有进程 | 彻底卸载软件后,删除安装目录(通常为C:\Program Files\PicGo),重新下载安装。 |
| 新版本上传失败 | 检查配置参数是否符合新版本要求(如分支名、域名格式),建议重新填写配置并保存。 |
| 上传后链接无法访问 | 确认仓库为公开权限,且自定义域名中的用户名、仓库名、分支名拼写正确。 |