Obsidian 使用腾讯云 COS 搭建图床：安装、配置与图片管理
Obsidian 使用腾讯云 COS 搭建图床：安装、配置与图片管理
写 Obsidian 笔记时，直接粘贴截图虽然方便，但图片会不断堆积在本地仓库中。时间一长，不仅仓库越来越大，Git 同步、跨设备访问和文章发布也会变得麻烦。
Tencent COS for Imgur 是一款由 bobostudio 开发的 Obsidian 插件。它可以把粘贴或拖入笔记的图片自动上传到腾讯云 COS，并将本地图片引用替换为云端链接。
本文从零完成一次配置，并在最后验证图片能否正常上传。
一、它能解决什么问题
配置完成后，在 Obsidian 中复制粘贴或拖入图片，插件会自动完成：
- 将图片上传到腾讯云 COS；
- 生成图片的云端访问地址；
- 把地址插入当前 Markdown 笔记；
- 在图片管理面板中统一查看和删除图片。
插件还支持：
- 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 | 存储桶所在地域 |
建议为博客图片单独创建存储桶，便于后续统计用量、设置权限和迁移数据。
公有读还是私有读
- 公有读、私有写：图片可以通过普通短链接访问，适合公开博客配图；
- 私有读写：访问图片需要带签名链接，更适合含隐私内容的笔记。
[!warning]
公有读意味着任何拿到图片地址的人都可以访问文件。存储桶中不要混放身份证、合同、内部系统截图等敏感资料。
四、获取 SecretId 和 SecretKey
进入腾讯云控制台的 访问管理 → API 密钥管理，新建或查看 API 密钥。
复制并妥善保存：
SecretIdSecretKey
[!danger]
不要把真实密钥写进笔记、截图、Git 仓库或公开文章。正式使用时，建议创建权限受限的子账号密钥，只授予目标 COS 存储桶所需的权限。
五、配置跨域访问 CORS
这一步很关键。没有正确配置 CORS 时，插件可能无法从 Obsidian 向 COS 上传文件。
进入目标存储桶，找到 安全管理 → 跨域访问 CORS 设置，新增规则。桌面端使用时，在来源 Origin 中填写：
app://obsidian.md
如果还要在手机端上传，插件原教程建议将来源设置为：
** 代表允许任意来源，范围更宽。仅使用桌面端时，优先使用 app://obsidian.md。
六、安装并启用插件
在 Obsidian 中依次打开：
设置 → 第三方插件 → 浏览搜索 Tencent COS for Imgur 或 tencent，安装后启用插件。
如果社区插件市场暂时无法访问，也可以前往项目的 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/ 目录中。
填写完成后，先点击插件设置中的 测试连接。看到连接成功提示后，再进行下一步。
八、测试图片上传
新建一篇测试笔记，然后任选一种方式：
方法 1：复制粘贴
复制一张截图，将光标放到笔记中，按 Ctrl + V。插件会自动上传图片并插入 Markdown 图片链接。
方法 2：拖拽上传
将本地图片直接拖入 Obsidian 编辑器，插件同样会自动上传。
成功后，笔记中的内容应类似：
再到腾讯云 COS 控制台检查目标目录。如果图片已经出现，并且 Obsidian 中能够正常显示，说明配置成功。
九、管理已经上传的图片
插件提供两种入口：
- 按
Ctrl + P（macOS 为Cmd + P），搜索并运行“管理 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 为准。