免费图床搭建指南：Gitee + PicGo + Typora + Obsidian 全流程
写博客、记笔记离不开图片，但图片存哪一直是个问题。本文教你用 Gitee（码云）搭建免费图床，配合 PicGo 实现一键上传，并接入 Typora 和 Obsidian 两大笔记软件，实现粘贴即上传的丝滑体验。
一、方案介绍
图床就是专门用来存放图片的服务器，上传图片后返回一个 URL 链接，你在文章里引用这个链接就能展示图片。
| 方案 | 费用 | 优点 | 缺点 |
|---|---|---|---|
| Gitee 图床（本教程） | 免费 | 免费、国内访问快、稳定 | 仓库有容量限制，图片多了可能需要清理 |
| 腾讯云对象存储 COS | 约 10+ 元/年 | 容量大、速度快 | 需要付费 |
| GitHub 图床 | 免费 | 容量大 | 国内访问慢，可能需要科学上网 |
本教程选择Gitee + PicGo的组合，完全免费，国内访问速度快，适合个人博客和笔记使用。
这是同学的腾讯云对象存储的付费方案教程和GitHub 图床教程，可提供帮助，勤奋又努力的他值得👏
基于腾讯云对象存储 COS 与 PicGo 的 Obsidian 自动化图床方案深度实践_picgo连接cos-CSDN博客
如何在gitee/github上面搭建obsidian的图床_gitee 图片床-CSDN博客
二、准备工作
需要提前安装好以下软件：
Typora（或 Obsidian）—— Markdown 编辑器
PicGo—— 图片上传工具
Node.js—— PicGo 插件依赖的运行环境（PicGo 2.x 需要安装，3.x 版本可跳过）
三、Gitee 中创建仓库并生成 Token
1. 新建仓库
登录 Gitee，点击右上角+号 →新建仓库。
关键设置：
仓库名称：随意，比如
picture是否开源：选择开源（重要！选私有图片无法公开访问）
初始化仓库：勾选，添加一个 README 文件
2. 生成私人令牌（Token）
进入 Gitee → 右上角头像 →设置→私人令牌→生成新令牌。
勾选权限：只需要勾选projects（仓库相关权限）即可
提交后会要求输入密码验证
验证通过后，页面会显示一串 Token 字符串
⚠️重要提醒：Token 只在生成时显示一次，请立即复制保存到安全的地方！关闭页面后就再也看不到了。如果丢了只能重新生成。
四、安装 PicGo 和 Node.js
1. 下载 PicGo
前往 PicGo 官方发布页下载：Releases · Molunerfinn/PicGo
往下滚动找到对应平台的安装包：
这里给出Window64位:https://release.picgo.app/3.0.0/PicGo-3.0.0-x64.exe，下载时如果浏览器提示有风险（出现感叹号），点击「保留」即可，这是正常的安全提示。
2. 安装 Node.js（PicGo 2.x 需要）
前往 Node.js 官网 下载 LTS（长期支持版）并安装。
安装完成后，打开命令行（Win+R 输入cmd），输入：
node -v
如果显示版本号（如v22.x.x），说明安装成功。
💡 PicGo 3.x 版本已经内置了运行环境，可以跳过 Node.js 的安装。
五、配置 PicGo
1. 设置中文界面
打开 PicGo → 右上角设置（齿轮图标） → 找到语言设置，切换为中文。
2. 安装 Gitee 上传插件
PicGo 默认不包含 Gitee 图床，需要安装插件：
点击左侧插件设置
搜索
gitee安装gitee-uploader插件
⚠️ 如果插件安装失败，请检查 Node.js 是否正确安装（命令行输入
node -v有版本号输出）。
检查一下是不是地址端口对不对，一般都是这个，可以再看看。
3. 开启时间戳重命名
点击左侧PicGo 设置→ 开启时间戳重命名。
这样可以避免图片重名覆盖，每张图片的文件名都是唯一的时间戳。
4. 配置 Gitee 图床
点击左侧图床设置→ 找到Gitee，填写以下信息：
| 配置项 | 说明 | 示例 |
|---|---|---|
| 仓库名 | 你的 Gitee 用户名/仓库名 | zero111888/picture |
| 分支名 | 仓库分支，默认master | master |
| Token | 第三步生成的私人令牌 | a1b2c3d4e5... |
| 存储路径 | 图片在仓库中的存放目录（可选） | img/ |
| 自定义域名 | 留空即可，Gitee 会自动生成 | （不填） |
💡仓库名格式是
用户名/仓库名，比如你的 Gitee 主页是https://gitee.com/zero111888，仓库名是picture，那这里就填zero111888/picture。
填写完成后点击确定，然后点击设为默认图床。
5. 测试上传
在 PicGo 的上传区，拖入一张图片或点击选择一张图片上传。
如果配置正确，上传成功后会显示通知，并且剪贴板会自动复制图片的 URL 链接。你可以粘贴到浏览器中验证图片是否能正常显示。
❌ 如果上传失败，请检查：
仓库是否设为开源
Token 是否正确（是否多复制了空格）
仓库名格式是否为
用户名/仓库名网络是否正常
六、Typora 接入图床
Typora 可以配置为自动上传图片到图床，实现粘贴图片即上传。
配置步骤
打开 Typora →文件→偏好设置→图像
插入图片时：选择上传图片
上传服务：选择PicGo(app)
PicGo 路径：选择你安装的 PicGo 程序路径（如
C:\Program Files\PicGo\PicGo.exe）点击验证图片上传选项进行测试
验证成功后，你在 Typora 中粘贴截图或拖入图片时，Typora 会自动调用 PicGo 上传到 Gitee，并将返回的 URL 链接插入到文档中。
七、Obsidian 接入图床
1. 安装图片上传插件
打开 Obsidian →设置→第三方插件
关闭安全模式（如果已开启）
点击浏览，搜索
Image Auto Upload（或obsidian picgo）找到对应插件并安装，然后启用
2. 配置上传接口
进入插件设置页面：
上传方式：选择PicGo
接口地址：默认
http://127.0.0.1:36677（PicGo 本地服务端口）
⚠️ 确保 PicGo 已打开且PicGo 设置 → 设置 Server中的端口与插件一致（默认 36677）。
配置完成后，在 Obsidian 中粘贴图片时会自动上传到 Gitee 图床。
八、常见问题
Q1：上传失败，提示 401 未授权？
Token 错误或已过期。重新到 Gitee 生成令牌，更新 PicGo 配置。
Q2：图片上传成功但链接打不开？
仓库设为了私有。进入 Gitee 仓库 →管理→ 将仓库改为开源。
Q3：PicGo 插件安装失败？
确认 Node.js 已安装（命令行输入
node -v有输出）尝试更换 npm 源：在 PicGo 设置中设置 npm 镜像为
https://registry.npmmirror.com重启 PicGo 后重试
Q4：Typora 验证图片上传失败？
确认 PicGo 已打开并正在运行
确认 PicGo 路径填写正确（指向
.exe程序文件）尝试重启 Typora
Q5：Gitee 仓库满了怎么办？
Gitee 单个仓库有容量限制（通常 500MB）。解决方案：
定期清理不需要的图片
新建一个仓库继续使用
如果图片量大，建议迁移到腾讯云 COS（一年十几块）
Q6：Obsidian 插件上传图片没反应？
检查 PicGo 是否在运行
检查 Server 端口是否匹配
尝试手动上传一张图片测试
九、总结
整个流程回顾：
Gitee 建仓库（开源） → 生成 Token ↓ 安装 PicGo + Node.js → 安装 gitee 插件 → 配置图床信息 ↓ Typora / Obsidian 对接 PicGo → 完成！
搭建完成后，你在 Typora 或 Obsidian 中粘贴截图，图片会自动上传到 Gitee 仓库并返回链接，写博客时再也不用担心图片丢失了。
方案优缺点：
✅免费：不花一分钱
✅国内速度快：Gitee 是国内的，访问比 GitHub 快很多
✅支持多端：Typora、Obsidian 都能用
⚠️容量有限：Gitee 仓库有大小限制，图片多了需要清理
⚠️不适合大量图片：如果是图量大的商用场景，建议使用腾讯云 COS