GitHub+PicGo 图床搭建全流程教程

一、图床相关介绍

1. 什么是图床

图床是一种专注于图片存储与分发的在线服务,核心功能是:
用户上传本地图片至云端服务器后,系统自动生成可直接访问的图片链接。通过该链接,用户可在任意平台(如博客、文档、社交软件)引用图片,无需关心图片的存储位置和带宽消耗。

2. 图床能解决的问题

  • 存储问题:为个人用户或小型网站提供低成本(甚至免费)的图片存储方案,避免占用自有服务器空间和带宽。
  • 分享问题:统一图片访问链接,解决本地图片在不同设备/平台间传输的繁琐性。
  • 管理问题:多数图床支持图片分类、标签标注等管理功能,便于批量查找和复用。
  • 性能问题:依托CDN(内容分发网络)加速,提升全球各地用户的图片加载速度。
  • 安全性问题:部分图床提供防盗链、访问权限设置等功能,保护图片不被非法盗用。

二、在GitHub上创建图床

1. 解决GitHub访问速度慢的问题

推荐使用 Watt Toolkit(原Steam++)优化访问速度:

  • 下载并安装工具后,启动程序并勾选「GitHub加速」选项,无需额外配置即可生效。

2. 创建仓库

  1. 登录GitHub账号(无账号需先注册)。
  2. 点击右上角「+」图标,选择「New repository」。
  3. 填写仓库信息:

    • 仓库名称:建议使用img-bedpicture-storage等直观名称。
    • 仓库描述:可选填(如「个人图片存储仓库」)。
    • 可见性:选择「Public」(公开仓库可通过CDN加速访问)。
  4. 点击「Create repository」完成创建。

3. 生成token令牌(关键步骤)

  1. 点击右上角头像,选择「Settings」进入设置页面。
  2. 在左侧菜单中依次展开:「Developer settings」→「Personal access tokens」→「Tokens (classic)」。
  3. 点击「Generate new token」→「Generate new token (classic)」。
  4. 配置令牌参数:

    • Note:填写令牌用途(如「PicGo图床访问权限」)。
    • Expiration:选择令牌有效期(建议选「No expiration」避免频繁更新)。
    • Scopes:勾选「repo」权限(获取仓库读写权限)。
  5. 点击「Generate token」生成令牌,立即复制并保存到本地文档(令牌仅显示一次,丢失需重新生成)。

三、PicGo相关操作

1. PicGo介绍

PicGo是一款开源免费的图片上传工具,支持GitHub、阿里云OSS、腾讯云COS等多种图床,核心优势:

  • 支持拖拽上传、剪贴板图片上传等快捷操作。
  • 自动生成Markdown、HTML等格式的图片链接。
  • 可配置默认图床,实现「一键上传」。

2. 下载与安装

  • 官方下载地址PicGo GitHub Release
  • 选择对应系统版本(Windows用户选.exe,macOS用户选.dmg),下载后双击安装即可。

3. 配置GitHub图床(核心步骤)

  1. 打开PicGo软件,点击左侧「图床设置」,选择「GitHub图床」。
  2. 填写配置参数:

    • 仓库名:格式为「GitHub用户名/仓库名」(如yourname/img-bed)。
    • 分支名:填写仓库默认分支(通常为mainmaster)。
    • Token:粘贴第二步中保存的GitHub令牌。
    • 存储路径:可选填(如2024/,表示图片按年分类存储)。
    • 自定义域名:填写CDN加速地址,格式为
      https://cdn.jsdelivr.net/gh/用户名/仓库名@分支名
      (示例:https://cdn.jsdelivr.net/gh/yourname/img-bed@main)。
  3. 点击「确定」保存配置,建议勾选「设为默认图床」。

4. 常见错误解决

问题现象解决方法
报错“Error: ENOENT: no such file or directory, open...picgo.log”打开文件管理器,输入路径%APPDATA%\picgo,删除data.json文件后重启软件(建议先备份)。
双击图标无反应,但后台有进程彻底卸载软件后,删除安装目录(通常为C:\Program Files\PicGo),重新下载安装。
新版本上传失败检查配置参数是否符合新版本要求(如分支名、域名格式),建议重新填写配置并保存。
上传后链接无法访问确认仓库为公开权限,且自定义域名中的用户名、仓库名、分支名拼写正确。
最后修改:2025 年 07 月 17 日
如果觉得我的文章对你有用,请随意赞赏