保姆级教程：Obsidian + PicGo + Gitee 搭建免费稳定的自动化图床

版权声明
Made By Hanbin Yi
未经许可请勿转载

本文档详细介绍了如何利用 Auto Upload Images 插件配合 PicGo 和 Gitee，构建一套免费、稳定的 Obsidian 自动化图床方案，解决本地图片同步与分享的难题。

---

1. 方案架构与核心概念

本方案旨在实现“插入图片即上传，本地链接自动转云端”的自动化流程。

1.1 核心组件

• Obsidian 插件 (Auto Upload Images)：
  • 角色：监听者与桥梁。
  • 功能：监听笔记中的图片插入事件（粘贴/拖拽），自动调用 PicGo 进行上传，并将上传成功后的 URL 替换回笔记中。
• 上传工具 (PicGo)：
  • 角色：搬运工。
  • 功能：一款开源的图片上传工具，支持对接 Gitee、GitHub、阿里云 OSS 等多种图床，负责文件的重命名、上传及生成访问链接。
• 云端存储 (Gitee)：
  • 角色：仓库。
  • 功能：利用 Gitee（码云）的代码仓库作为免费图床，存储图片文件并提供访问服务。

1.2 工作流程

1. Obsidian：用户粘贴图片。
2. 插件：拦截粘贴行为，发送图片给 PicGo。
3. PicGo：将图片上传至 Gitee 仓库。
4. Gitee：返回图片的网络链接（URL）。
5. 插件：将笔记中的本地路径（如 Pasted image...png）自动替换为 Gitee 的网络链接。

---

2. 环境搭建：PicGo + Gitee

2.1 Gitee 仓库准备

1. 登录 Gitee，新建一个仓库（Repository）。
2. 关键设置：仓库必须设置为 “开源”（Public），否则外部无法访问图片链接。
3. 获取 私人令牌 (Token)：
   • 进入 设置 -> 安全设置 -> 私人令牌 -> 生成新令牌。
   • 权限勾选 projects (管理项目) 即可。
   • 注意：生成后请立即复制保存，Token 只会显示一次。

2.2 PicGo 安装与配置

1. 下载安装：前往 PicGo GitHub 下载对应系统的安装包。
2. 安装插件：打开 PicGo 主界面 -> 插件设置 -> 搜索并安装 gitee 插件（推荐 gitee-uploader 或类似高星插件）。
3. 图床配置：
   • 进入 图床设置 -> Gitee。
   • 配置项说明：
     • repo: 仓库路径，格式为 用户名/仓库名 (例如 anatc/my-notes-photo)。
     • branch: 分支名，通常为 master。
     • token: 刚才在 Gitee 生成的私人令牌。
     • path: (可选) 图片存储的子目录，如 img/。
     • customPath: (可选) 自动重命名规则，建议开启以防文件名冲突。

图 1：PicGo 中 Gitee 图床配置示例

4. 验证：配置完成后，点击“确定”并设置为默认图床。可在 PicGo 上传区拖入一张图片测试是否上传成功。

---

3. Obsidian 插件配置

3.1 安装插件

在 Obsidian 的 设置 -> 第三方插件 -> 市场 中搜索并安装 Auto Upload Images (或 Image Auto Upload Plugin)，安装后启用。

3.2 关联 PicGo

进入插件设置页面，进行如下配置：

• Upload Tool: 选择 PicGo。
• PicGo Server: 默认为 http://127.0.0.1:36677/upload (通常无需修改，除非修改了 PicGo 的监听端口)。

图 2：Auto Upload Images 插件配置界面

---

4. 注意事项与常见问题

4.1 文件名空格问题

现象：如果上传的图片文件名中包含空格（例如 Screen Shot 2025.png），可能会导致生成的 Markdown 链接被截断，无法正常显示。

错误示例：

图 3：文件名含空格导致链接截断示例

解决方案：

1. PicGo 设置：在 PicGo 设置中开启 “上传前重命名” 或 “时间戳重命名”，确保上传到 Gitee 的文件名不含空格。
2. 手动规范：在粘贴前确保本地文件名规范，使用下划线 _ 或连字符 - 代替空格。

4.2 网络问题

由于 Gitee 服务器在国内，速度通常较快。但如果 PicGo 上传失败，请检查：

• Token 是否过期。
• 仓库是否被误设为私有。
• PicGo 的 Server 端口（36677）是否被防火墙拦截。