Tencent COS for Imgur

approved

by bobostudio

Upload images to Tencent COS for Imgur.

★ 21 stars↓ 555 downloadsUpdated todayMIT
View on GitHub

banner

腾讯云 COS 图床插件

这是一个用于 Obsidian 的图片上传插件，可将笔记中的图片自动上传到腾讯云 COS，实现云端存储、管理与备份。

新增功能 (2026-03-26)

  • 支持拖拽/粘贴上传多格式文件（PDF、MP3、MP4、WAV、DOC、DOCX、XLS、XLSX、PPT、PPTX、ZIP、MOV、WebM）

  • 本地和在线笔记备份，备份路径自定义

  • 鼠标悬浮图片，支持拖拽图片改图片大小(支持本地和线上图片)

  • 图片管理功能，可查看和删除已上传的图片，支持面板和命令方式打开

  • 新增设置图片链接的有效期，新增测试连接功能

  • 新增是否开启公有读存储桶

备份笔记演示

笔记备份

笔记备份

注意：

  • 本地笔记备份：这篇笔记的图片都是本地链接还没上传与备份
  • 在线笔记备份：这篇笔记的图片都是线上链接还没备份

拖拽图片演示

拖拽图片

新增的设置

设置

  • 备份路径支持自定义，默认当前笔记仓库下

  • 新增设置图片链接的有效期 20年,50年,永久

  • 测试连接可以调试你配置是否正常

设置打开图片管理面板

图片管理删除

命令打开图片管理面板

图片管理删除命令

是否开启公有读存储桶

腾讯云进入 COS 控制台 找到你的存储桶 → 权限管理 → 存储桶访问权限设置

公有读存储桶

公有读存储桶

开启公有读存储桶 图片为短链接如 https://xxx.com/20260210143554.png

建议：如果图片是公开的（如博客配图），可以开启公有读； 如果图片包含隐私内容，保持私有读模式更安全。

功能特点

  • 支持拖拽、复制粘贴上传图片
  • 自动替换本地图片链接为云端链接
  • 支持图片悬浮拖拽调整大小（本地与线上图片均支持）
  • 支持本地笔记备份与在线笔记备份，且备份路径可自定义
  • 支持图片管理面板（预览、分页、单选/全选、批量删除）
  • 支持通过命令面板或设置页快速打开图片管理
  • 支持图片链接有效期设置（20年、50年、永久）与刷新有效期
  • 支持测试连接，快速校验 COS 配置是否可用
  • 支持公有读存储桶开关，适配公开图片与私有图片场景
  • 支持存储桶地域选择与自定义存储路径前缀
  • 支持图片格式（PNG、JPG、JPEG、GIF、SVG、WebP）
  • 支持多格式文件上传（PDF、MP3、MP4、WAV、DOC、DOCX、XLS、XLSX、PPT、PPTX、ZIP、MOV、WebM）

新手快速上手（3分钟）

  1. 在腾讯云创建 COS 存储桶，并准备好 SecretId / SecretKey
  2. 在 Obsidian 安装并启用插件
  3. 在插件设置填写 SecretId、SecretKey、Bucket、Region
  4. 点击“测试连接”确认配置可用
  5. 在笔记中直接拖拽或粘贴图片，自动上传并替换为云端链接

使用前准备

  1. 注册腾讯云账号并开通 COS 服务 开通 COS 服务
  2. 创建存储桶，记录存储桶名称（Bucket）和所在地域（Region）
  3. 获取 SecretId 和 SecretKey
  4. 访问 腾讯云控制台
  5. 进入「访问密钥」-> API 密钥管理

获取密钥

跨域访问 CORS 设置（注意）

复制到来源 Origin 的输入框内

app://obsidian.md

跨域访问 CORS 设置1 跨域访问 CORS 设置2

❗❗❗ 注意想在手机上使用需要把 app://obsidian.md 改成 *

手机端安装方法(以 IOS 为例，安卓同理)
  1. 打开 Obsidian 设置
  2. 点击 Community plugins
  3. 搜索 tencent
  4. 安装并开启插件
  5. 填写图床信息
  6. 笔记上传图片
{1}{2}{3}
{4}{5}{6}
{7}{8}{9}
{10}{11}

电脑端安装方法

  1. 打开 Obsidian 设置
  2. 进入 "第三方插件" -> "浏览"
  3. 搜索 "Obsidian Imgur Plugin" 或者浏览器访问 Obsidian Imgur Plugin
  4. 点击安装并启用插件

启用插件

配置说明

  1. 进入插件设置页面
  2. 填写以下信息：
    • SecretId：腾讯云 API 密钥 ID
    • SecretKey：腾讯云 API 密钥 Key
    • Bucket：存储桶名称（例如：my-bucket-1250000000）
    • Region：存储桶所在地域
    • 存储路径前缀：文件在 COS 中的目录（例如：images）

存储路径前缀说明

比如你设置 img

存储路径前缀说明1

那你的 COS 的图片就会上传到 /img 文件夹下

存储路径前缀说明1

使用方法

方式一：拖拽上传

  • 直接将图片文件拖拽到编辑器中
  • 插件会自动上传图片并插入云端链接
  • 支持拖拽非图片文件（需在设置中开启"启用多格式文件上传"）

方式二：复制粘贴

  • 复制图片后，直接在编辑器中粘贴
  • 插件会自动上传图片并插入云端链接
  • 支持粘贴非图片文件（需在设置中开启"启用多格式文件上传"）

方式三：本地/线上笔记备份

  1. 在插件设置中先配置备份路径（默认在当前仓库下，可自定义）
  2. 按需选择备份方式并执行
  3. 备份类型说明：
    • 本地笔记备份：适用于图片仍为本地链接、尚未上传/备份的笔记
    • 在线笔记备份：适用于图片已是线上链接、尚未备份的笔记
  4. 执行后会按设置路径生成对应备份文件

方式四：图片管理

  1. 通过命令面板：

    • 按 Ctrl+P（Mac: Cmd+P）打开命令面板
    • 输入 "管理COS图片" 并选择该命令

  2. 通过设置页面：

    • 进入插件设置页面
    • 点击 "图片管理" 部分的 "打开图片管理" 按钮

  3. 功能说明：

    • 查看配置的存储路径下所有已上传的图片
    • 支持图片预览和基本信息显示（文件名、大小、上传时间）
    • 支持单选/全选图片
    • 支持批量删除选中的图片，删除前会弹出确认对话框
    • 支持分页加载，避免一次性加载过多图片
    • 删除操作会同步到COS，确保云端存储的一致性

方式五：多格式文件上传

  1. 在插件设置中开启 "启用多格式文件上传" 开关
  2. 默认支持的文件格式：pdf,mp3,mp4,wav,doc,docx,xls,xlsx,ppt,pptx,zip,mov,webm
  3. 如需添加其他格式，可在 "允许的文件类型" 设置中添加扩展名（用英文逗号分隔）
  4. 拖拽或粘贴非图片文件到编辑器中，插件会自动上传并插入链接
  5. 注意：非图片文件插入的是 [文件名](URL) 格式的链接

操作预览

操作预览

注意事项

  1. 首次使用请确保已正确配置腾讯云 COS 相关信息
  2. 上传前请确保网络连接正常
  3. 建议定期检查存储桶用量，避免超出配额
  4. 请妥善保管 SecretId 和 SecretKey，不要泄露给他人
  5. 存储路径前缀不要以斜杠开头或结尾

支持与反馈

如果您在使用过程中遇到任何问题，或有功能建议，请通过以下方式反馈：

打赏

打赏

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

Copyright (c) 2024 bobostudio

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.