Obsidian 使用腾讯云 COS 搭建图床:安装、配置与图片管理

使用 Tencent COS for Imgur 插件,将 Obsidian 中粘贴或拖入的图片自动上传到腾讯云 COS,并完成 CORS、存储路径和访问权限配置。

Obsidian 使用腾讯云 COS 搭建图床:安装、配置与图片管理

写 Obsidian 笔记时,直接粘贴截图虽然方便,但图片会不断堆积在本地仓库中。时间一长,不仅仓库越来越大,Git 同步、跨设备访问和文章发布也会变得麻烦。

Tencent COS for Imgur 是一款由 bobostudio 开发的 Obsidian 插件。它可以把粘贴或拖入笔记的图片自动上传到腾讯云 COS,并将本地图片引用替换为云端链接。

Tencent COS for Imgur 插件

本文从零完成一次配置,并在最后验证图片能否正常上传。

一、它能解决什么问题

配置完成后,在 Obsidian 中复制粘贴或拖入图片,插件会自动完成:

  1. 将图片上传到腾讯云 COS;
  2. 生成图片的云端访问地址;
  3. 把地址插入当前 Markdown 笔记;
  4. 在图片管理面板中统一查看和删除图片。

插件还支持:

  • PNG、JPG、JPEG、GIF、SVG、WebP 等图片格式;
  • PDF、音视频、Office 文档、ZIP 等多格式文件;
  • 自定义 COS 存储路径;
  • 本地笔记和在线笔记备份;
  • 图片链接有效期设置;
  • 拖拽调整本地或在线图片的显示大小;
  • 将笔记中的外链图片同步到 COS。

[!tip] 如果笔记需要发布为博客,使用自己的 COS 比依赖第三方公共图床更可控;如果笔记含有私人截图,则要谨慎选择存储桶权限。

二、开始前需要准备什么

你需要准备:

  • 一个腾讯云账号;
  • 已开通的对象存储 COS;
  • 一个 COS 存储桶;
  • 腾讯云 API 的 SecretId 和 SecretKey;
  • 桌面端或移动端 Obsidian。

整个配置过程可以概括为:

创建 COS 存储桶
      ↓
获取 SecretId / SecretKey
      ↓
配置存储桶 CORS
      ↓
安装并配置 Obsidian 插件
      ↓
测试连接并粘贴图片

三、创建 COS 存储桶

进入腾讯云 COS 控制台,创建一个存储桶。创建时重点记住下面两个参数:

参数 示例 说明
Bucket my-blog-1250000000 完整的存储桶名称,通常带账号 ID 后缀
Region ap-guangzhou 存储桶所在地域

建议为博客图片单独创建存储桶,便于后续统计用量、设置权限和迁移数据。

公有读还是私有读

  • 公有读、私有写:图片可以通过普通短链接访问,适合公开博客配图;
  • 私有读写:访问图片需要带签名链接,更适合含隐私内容的笔记。

腾讯云 COS 存储桶访问权限设置

腾讯云 COS 公有读权限配置

[!warning] 公有读意味着任何拿到图片地址的人都可以访问文件。存储桶中不要混放身份证、合同、内部系统截图等敏感资料。

四、获取 SecretId 和 SecretKey

进入腾讯云控制台的 访问管理 → API 密钥管理,新建或查看 API 密钥。

获取腾讯云 API 密钥

复制并妥善保存:

  • SecretId
  • SecretKey

[!danger] 不要把真实密钥写进笔记、截图、Git 仓库或公开文章。正式使用时,建议创建权限受限的子账号密钥,只授予目标 COS 存储桶所需的权限。

五、配置跨域访问 CORS

这一步很关键。没有正确配置 CORS 时,插件可能无法从 Obsidian 向 COS 上传文件。

进入目标存储桶,找到 安全管理 → 跨域访问 CORS 设置,新增规则。桌面端使用时,在来源 Origin 中填写:

app://obsidian.md

COS 跨域访问 CORS 设置入口

为 Obsidian 配置 CORS 规则

如果还要在手机端上传,插件原教程建议将来源设置为:

*

* 代表允许任意来源,范围更宽。仅使用桌面端时,优先使用 app://obsidian.md。

六、安装并启用插件

在 Obsidian 中依次打开:

设置 → 第三方插件 → 浏览

搜索 Tencent COS for Imgur 或 tencent,安装后启用插件。

安装并启用 Tencent COS for Imgur

如果社区插件市场暂时无法访问,也可以前往项目的 GitHub Releases 下载发布文件,再放入当前仓库的插件目录:

.obsidian/plugins/imgur-tencent-cos/

七、填写插件配置

打开:

设置 → 第三方插件 → Tencent COS for Imgur

依次填写:

配置项 填写内容
SecretId 腾讯云 API 密钥 ID
SecretKey 腾讯云 API 密钥 Key
Bucket 完整存储桶名称,如 my-blog-1250000000
Region 存储桶地域,如 ap-guangzhou
存储路径前缀 可选,如 images 或 blog

存储路径前缀不要以 / 开头或结尾。例如填写:

images

上传后的文件会保存在 COS 的 images/ 目录中。

设置 COS 存储路径前缀

COS 中生成对应的图片目录

填写完成后,先点击插件设置中的 测试连接。看到连接成功提示后,再进行下一步。

八、测试图片上传

新建一篇测试笔记,然后任选一种方式:

方法 1:复制粘贴

复制一张截图,将光标放到笔记中,按 Ctrl + V。插件会自动上传图片并插入 Markdown 图片链接。

方法 2:拖拽上传

将本地图片直接拖入 Obsidian 编辑器,插件同样会自动上传。

拖拽图片上传到 COS

成功后,笔记中的内容应类似:

![图片说明](https://你的存储桶域名/images/20260724123456.png)

再到腾讯云 COS 控制台检查目标目录。如果图片已经出现,并且 Obsidian 中能够正常显示,说明配置成功。

九、管理已经上传的图片

插件提供两种入口:

  1. 按 Ctrl + P(macOS 为 Cmd + P),搜索并运行“管理 COS 图片”;
  2. 进入插件设置,在“图片管理”区域点击“打开图片管理”。

图片管理面板支持预览、分页、单选、全选和批量删除。

COS 图片管理面板

[!warning] 从面板删除图片会同步删除 COS 中的对象。如果 Markdown 笔记仍然引用该地址,图片将无法显示,删除前应确认引用关系。

十、常见问题

1. 点击测试连接失败

按顺序检查:

  • SecretId 和 SecretKey 是否复制完整;
  • Bucket 是否包含账号 ID 后缀;
  • Region 是否与存储桶实际地域一致;
  • 密钥对应账号是否有该存储桶的访问权限;
  • 网络是否可以正常访问腾讯云 COS。

2. 可以测试连接,但粘贴图片失败

优先检查 CORS 设置。桌面端来源应包含:

app://obsidian.md

手机端使用时,需要按照插件说明调整来源规则。

3. 上传成功,但博客中图片无法显示

可能原因包括:

  • 存储桶为私有读,生成的签名链接已经过期;
  • 图片地址被防盗链规则拦截;
  • 博客站点使用 HTTPS,而图片地址仍为 HTTP;
  • COS 对象已被删除或移动。

公开博客通常更适合使用公有读图片,或者为 COS 配置自定义域名/CDN;含隐私内容的笔记则应继续使用私有读。

4. 图片链接太长

私有读存储桶的图片地址通常带有签名参数,因此比较长。若图片确定用于公开博客,可以将存储桶配置为公有读,并在插件中开启相应选项。

5. 是否可以上传 PDF 或视频

可以。在插件设置中开启“启用多格式文件上传”,默认支持:

pdf, mp3, mp4, wav, doc, docx, xls, xlsx,
ppt, pptx, zip, mov, webm

非图片文件会以普通 Markdown 链接的形式插入:

[文件名.pdf](https://你的存储桶域名/files/文件名.pdf)

十一、使用建议

  • 为博客图片单独建立存储桶和 API 子账号;
  • 使用 blog、notes 等路径前缀分类存放;
  • 不要把 API 密钥提交到 Git;
  • 定期检查 COS 的存储量和外网下行流量;
  • 删除图片前先确认文章中是否仍有引用;
  • 重要文章保留本地或其他云端备份,避免只有一份数据。

总结

完成 COS 存储桶、API 密钥、CORS 和插件参数配置后,在 Obsidian 中粘贴图片就能自动获得云端链接。对于使用 Obsidian 写博客、通过 Git 管理文章或需要多端同步的人来说,这套方案可以明显减少本地附件带来的维护成本。

本文依据插件项目的官方说明整理。插件功能和界面可能随版本更新而变化,遇到差异时请以 bobostudio/obsidian-imgur-plugin 的最新 README 和 Releases 为准。