Obsidian

笔记同步助手图床接力功能教程

笔记同步助手 · ·Obsidian 教程
Obsidian图床PicGo教程

同步完成后自动把 Obsidian 图片换成你自己图床的链接

用「本地图片」模式同步 Obsidian 后，图片会下载到 vault，笔记里会出现 ![[笔记同步助手/images/xxx.jpg]] 这样的本地链接。

图床接力做的事：同步末尾自动调用你已经装好的第三方图床插件，把这些本地图片批量上传到你自己的图床（PicGo / PicList / AWS S3 / Cloudflare R2 / GitHub / 腾讯云 COS 等），笔记里的图片链接最后变成 ![](https://你的图床域名/xxx.jpg)。

适合谁用

  • 想把 Obsidian 笔记同步到博客、公众号等外部平台的人——远端链接才能在别处直接渲染

  • 不想让 vault 塞满图片文件的人

  • 有自己 CDN、希望所有图片走自家域名的人

支持哪些图床插件

三选一，装好哪个就在笔记同步助手里选哪个。笔记同步助手只负责调度，不碰任何图床的配置和凭证。

  • Image auto upload (PicGo/PicList)：本地装了 PicGo 或 PicList 桌面应用时用。社区插件市场搜 “Image auto upload”。

  • Image Upload Toolkit：直连 AWS S3 / Cloudinary / 腾讯云 COS / GitHub 时用。社区插件市场搜 “Image Upload Toolkit”。

  • Obsidian Image Uploader (Creling)：自定义 HTTP 图床接口时用。社区插件市场搜 “Obsidian Image Uploader”。

开启步骤

1. 前置条件

  • 桌面版 Obsidian。三个候选图床插件都不支持手机。

  • 笔记同步助手「图片处理模式」要设置为「本地图片」（LOCAL）。

2. 装好图床插件并配好

各图床插件的配置看各自 README，这里不展开。核心动作：先在图床插件里手动点一次“上传全部图片”，确认能正常传到你的图床，再回来做下一步。没跑通就往下配没有意义。

3. 打开笔记同步助手 → 设置 → 图片处理

往下翻会看到「图床接力 / image upload relay」下拉框。选中你装好的那个插件。下拉框下方会实时显示状态角标：

  • ✅ 已就绪：可以用了

  • ⚠️ 插件未启用 / 命令不存在 / 设置不完整：按提示去修，修完再回来

4. Image Upload Toolkit 用户：务必打开 Replace Original Document

打开 Image Upload Toolkit 的设置，把「Replace Original Document」开关打开。不开的话，toolkit 只会把上传后的 URL 放进剪贴板，笔记原文不变，接力等于没做。状态角标会提醒你这一点，但建议上手先开好。

5. 所有图床插件：务必关闭“删除源文件”

在 PicGo 类插件里这个开关叫 “Delete Source File / 删除源文件”。

关闭它之后，图床插件上传完会保留本地图片。下次再同步，笔记同步助手看到同样的图还在，会跳过（已经本地化过），皆大欢喜。

要是开了删除源文件，下次同步笔记同步助手会发现本地文件被删了，于是重新下载再次接力上传，白白消耗你的图床配额。

同步时会发生什么

开启接力后，同步主流程最后多一个「接力图床」阶段：

  1. 笔记同步助手照常把新文章拉下来、图片下载到 vault（这一步和以前完全一样）

  2. 拉完之后进入「接力图床」阶段

  3. 对本次同步涉及到的每篇笔记：打开它（视图会短暂切过去），调用图床插件的“上传全部图片”命令，等上传完成（每张图预算约 4 秒，视网络与图床响应速度）

  4. 完成后同步结束，笔记里的 ![[...]] 全部被写成 ![](https://...)

接力失败怎么办

某篇笔记接力失败（超时、网络挂了、图床配额满了），笔记同步助手不会中断同步：

  • 失败的那几篇笔记保持本地 wiki 链接，vault 里的图也还在

  • 状态栏弹一条 Notice：“图床接力部分失败，见控制台”

  • 下次同步时失败的笔记会再试一次；也可以在 Obsidian 里手动跑一遍“上传全部图片”命令补上

常见问题

能不能在手机上用？

不能。三个候选图床插件都只支持桌面端。笔记同步助手手机端会自动跳过接力阶段，不影响其它同步动作。

选「远端图片」模式能用接力吗？

不需要。远端模式下笔记里本来就是图片的公网 URL，没有要接力的东西。接力选项只在「本地图片」模式下才出现。

想换一个图床插件怎么办？

下拉切到新插件就行。已经上传过的旧图片保持原样（链接还是指向老图床），只有下次同步里新下载到的图片走新图床。

可以同时用多个图床插件吗？

不行，只能选一个。确实要分平台走不同图床，建议分 vault。

接力失败会不会连累正文提取？

不会。接力是同步末尾的独立阶段，正文和图片本地化早就完成了。接力挂了最坏情况是笔记里还是本地图片链接，下次再接或者手动触发即可。

升级后这个功能默认开启吗？

默认关闭。需要你主动去设置里选一个图床插件，存量用户升级后行为完全不变。