Obsidian R2 Image Uploader 插件使用手册

Obsidian 是一款本地优先的知识管理软件，因为默认用 Markdown 存储文档，所以图片管理一直是“老大难”。当然，这是 Markdown 文档的通病。

最好的方式，莫过于把图片上传到图床。而且，作为知识管理的核心资产，图片也应该像文本一样，完全掌握在自己手上。

经过详细的分析对比，我决定采用自建图床的方案，使用 Cloudflare 的 R2 存储桶，作为我的第一选择。同时开发了 Obsidian 专用的图片管理插件，在 GitHub 上开源，具体功能如下：

具体配置可能有一丢丢麻烦，但是不用担心，跟着我的步骤一步一步做，一定不会错。

图床配置

如果没有 Cloudflare 账号，建议去注册一个。

创建存储桶

注册后登录，在左侧栏中找到 存储和数据库 ＞ R2 对象存储 > 概述。

在 R2 对象存储的概述页面，点击右侧的 创建存储桶，跳转到存储桶的创建页面。

参考我的配置创建即可。

设置自定义域名

存储桶创建后，默认是 对象 这个子页面。

切换到 设置 子页面，在 自定义域 选项中点击 添加，在弹出的对话框中输入一个自己的域名，然后继续。

预览 DNS 记录，没问题的话，直接点下方的 连接域。

稍等片刻，自定义域中的状态变成“活动”，Access 变成“已启用”，就说明配置成功了。

插件设置

下载安装

1. 从 obsidian-r2-uploader 下载插件的最新版本。
2. 如果不需要自己修改，只需要保留 main.js 、manifest.json 、styles.css 这三个文件即可。
3. 将 obsidian-r2-uploader 目录复制到你的 Obsidian 插件目录 <vault>/.obsidian/plugins/ 下。

软件配置

打开 Obsidian > 设置 > 第三方插件 > 启用 R2 Image Uploader 。

然后点击齿轮按钮，进入插件的设置对话框，依次输入以下内容：

Account ID 获取方式

在 Cloudflare 的 存储和数据库 > R2 对象存储 > 概述 页面右侧的 Account Details，中复制即可。

Access Key 获取方式

在以上 Account Details 中点击 Manage ，跳转到令牌创建页面。

点击 创建 Account API 令牌 ，跳转到创建帐户 API 令牌页面，参考我的设置，点击最下面的按钮完成创建。

创建成功后，将 访问密钥 ID 和 机密访问密钥 复制到插件设置对话框的对应位置。

设置完成后，点击 测试 确认连接成功，即可开始使用。

使用方法

上传图片

• 粘贴上传：复制图片 > Ctrl+V > 输入名称 > 自动插入 ![名称](URL)
• 命令上传：Ctrl+P > 上传图片到 R2 > 选择文件 > 输入名称 > 自动插入 ![名称](URL)

管理图片

点击侧边栏 🖼️ 图标，或 Ctrl+P > R2 图片管理 ，支持以下功能：

• 🔍 搜索文件名/路径
• ☑️ 批量选择删除
• 📋 复制 markdown 链接
• 🔗 复制 URL
• ✏️ 重命名（可同步替换笔记引用）
• 🗑️ 删除（检测引用笔记，可选清理引用）

常见问题

• 400 错误：检查 Account ID、Access Key ID、Secret Access Key 是否正确。
• 管理面板无图片：检查 S3 凭证（管理面板也使用 S3 凭证），点击设置中的「测试」验证。
• 如果不小心弄丢密钥，又不想重新创建 Account API 令牌，可以在 API 令牌管理页面，点击对应账户 API 令牌右侧的三点，在弹出的对话框中选择 轮转 ，即可更新密钥。