免费图床搭建指南：Gitee + PicGo + Typora + Obsidian 全流程

写博客、记笔记离不开图片，但图片存哪一直是个问题。本文教你用 Gitee（码云）搭建免费图床，配合 PicGo 实现一键上传，并接入 Typora 和 Obsidian 两大笔记软件，实现粘贴即上传的丝滑体验。

一、方案介绍

图床就是专门用来存放图片的服务器，上传图片后返回一个 URL 链接，你在文章里引用这个链接就能展示图片。

本教程选择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 主页是https://gitee.com/zero111888，仓库名是picture，那这里就填zero111888/picture。

填写完成后点击确定，然后点击设为默认图床。

5. 测试上传

在 PicGo 的上传区，拖入一张图片或点击选择一张图片上传。

如果配置正确，上传成功后会显示通知，并且剪贴板会自动复制图片的 URL 链接。你可以粘贴到浏览器中验证图片是否能正常显示。

❌ 如果上传失败，请检查：

• 仓库是否设为开源

• Token 是否正确（是否多复制了空格）

• 仓库名格式是否为用户名/仓库名

• 网络是否正常

六、Typora 接入图床

Typora 可以配置为自动上传图片到图床，实现粘贴图片即上传。

配置步骤

1. 打开 Typora →文件→偏好设置→图像

1. 插入图片时：选择上传图片

2. 上传服务：选择PicGo(app)

3. PicGo 路径：选择你安装的 PicGo 程序路径（如C:\Program Files\PicGo\PicGo.exe）

4. 点击验证图片上传选项进行测试

验证成功后，你在 Typora 中粘贴截图或拖入图片时，Typora 会自动调用 PicGo 上传到 Gitee，并将返回的 URL 链接插入到文档中。

七、Obsidian 接入图床

1. 安装图片上传插件

1. 打开 Obsidian →设置→第三方插件

2. 关闭安全模式（如果已开启）

3. 点击浏览，搜索Image Auto Upload（或obsidian picgo）

4. 找到对应插件并安装，然后启用

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