Obsidian配置图床教程

---

目前发布博客，上传图片有两种方式：

• 一种是手动把本地图片上传到博客网站服务器上，例如CSDN
• 另一种是 一劳永逸的方案（配置图床）

---

本人使用的 Obsidian，如果你像我一样，经常需要在CSDN或其他平台发文，每次都一张张拖拽图片可能会有点繁琐。这时，可以考虑配置一个“图床”。

简单来说，图床就是一个可以存放图片的网络服务器。你可以配置 Obsidian 或者 Typora，你在 Obsidian 里粘贴或拖拽图片，它就能自动上传到云端图床并生成网络链接，之后直接把文章内容复制到 CSDN 就行，图片都会正常显示，无需再手动拖拽上传。

---

⚙️ 核心配置步骤（以 Gitee 为例）

这套方案的核心是：Obsidian + Image Auto Upload 插件 + PicGo 上传工具 + Gitee 图床仓库。

1️⃣ 前期准备：注册账号与安装软件

1. 注册 Gitee 账号：访问 gitee.com 注册并登录。

2. 安装 PicGo：下载并安装 PicGo，这是负责上传图片的核心工具。

3. 安装 Node.js：下载并安装 Node.js。这一步很重要，因为 PicGo 需要它才能安装 Gitee 上传插件，🔗参考教程。

---

2️⃣ 配置 PicGo 连接 Gitee

1. 安装 Gitee 插件：打开 PicGo，进入「插件设置」，搜索 gitee 并安装（例如 gitee-uploader 等）。
   

2. 准备 Gitee 信息：

• 创建仓库：在 Gitee 新建一个公开仓库，记下仓库地址（如 你的用户名/仓库名）。

• 生成令牌：在 Gitee 的「设置」->「私人令牌」中，生成一个新令牌，权限勾选 projects，复制并保存好这个令牌（它只会显示一次）。

3. 填写 PicGo 配置：进入 PicGo 的「图床设置」->「Gitee」，填入刚才的信息：
   

📝 字段填写指南

字段	说明	填写示例/方法
图床配置名	给这个配置起个名字，方便你以后识别。	例如：Gitee图床（随意起名）
repo	你的 Gitee 仓库地址，格式为 用户名/仓库名。	例如：yourname/picbed
branch	仓库的分支名。	通常为 main 或 master，取决于你创建仓库时默认的分支。
token	Gitee 的个人访问令牌，用于授权 PicGo 上传文件。	从 Gitee 生成的一串密钥，例如 ghp_xxxxxxxxxxxx
path	图片在仓库中存放的路径（文件夹）。	例如：images/（可选，不填则放在仓库根目录）
customPath	自定义图片上传路径规则，一般留空。	留空即可
customUrl	自定义域名，用于图片访问的 URL 前缀。如果你使用 CDN 加速，可以填 CDN 地址。	例如：https://cdn.jsdelivr.net/gh/用户名/仓库名（不填则默认使用 Gitee 的 raw 地址）

---

3️⃣ 配置 Obsidian 插件

1. 安装插件：在 Obsidian 中，进入「设置」->「第三方插件」->「社区插件市场」，搜索并安装 Image Auto Upload Plugin，如下图。
   

2. 关联 PicGo：启用插件后，进入它的设置页面，在「上传接口」或 PicGo server URL 中，确保地址为 http://127.0.0.1:36677/upload。这是 PicGo 默认监听的地址，让 Obsidian 能把图片发给 PicGo 处理。
   

3. 检查 PicGo 服务：确保 PicGo 软件是打开状态，并且「PicGo 设置」->「设置Server」中的「开启Server」是启用状态。
   

---

4️⃣ 测试与最终发布

1. 测试：在 Obsidian 中随便粘贴一张截图，如果图片链接瞬间变成了 https://... 开头的网址，并且能在 PicGo 的「相册」看到记录，就说明大功告成了！
   

2. 发布到 CSDN：在 Obsidian 中写好文章后，全选复制所有内容。然后打开 CSDN 的 Markdown 编辑器，直接粘贴即可。因为图片已经是网络图片链接，CSDN 可以直接显示，无需再手动上传。

💡 备选方案与其他提示

• 如果你想用 GitHub：步骤基本一致，只是 PicGo 的图床设置选择 GitHub，并且 GitHub 需要生成的是 Token（经典），权限勾选 repo。GitHub 仓库是国外的，访问可能不太稳定，但可以通过配置自定义域名（如 https://cdn.jsdelivr.net/gh/用户名/仓库名）来加速，🔗参考教程。

• 如果你不想自建仓库：PicGo 也支持 SM.MS 等免费公共图床，注册后获取 API Token 填入 PicGo 即可，🔗参考教程。这种方式更简单，但需要注意免费图床的服务稳定性。

• 关于文件名：建议在 PicGo 设置中开启「时间戳重命名」，避免因图片重名或文件名含空格导致上传后无法显示的问题。