Cloudflare R2 存储配置

Cloudflare R2 存储配置指南

Cloudflare R2 是一款兼容 S3 协议的对象存储服务。它最大的优势在于完全免除流出流量费 (Egress Fees)，这使其成为 Obsidian 多端同步和云盘超链接功能的理想选择。

准备工作

1. 登录 Cloudflare 控制台。
2. 在左侧菜单选择 R2。
3. 如果是首次使用，可能需要绑定一张双币信用卡或 PayPal 进行身份验证（R2 有非常慷慨的免费额度：每月 10GB 存储，A 类操作 100 万次，B 类操作 1000 万次）。

第一步：创建 Bucket

1. 点击 Create bucket。
2. 输入 Bucket 名称（例如 my-obsidian-vault）。
3. 选择距离你较近的地区（或者选择默认的 Automatic）。
4. 点击 Create bucket 完成创建。

第二步：获取 API 凭证

1. 返回 R2 首页，点击右侧的 Manage R2 API Tokens。
2. 点击 Create API token。
3. 权限选择 Edit (允许读写)。
4. 在 TTL 中选择 Forever 或你需要的有效期。
5. 点击 Create API Token。
6. 重要：记录下生成的 Access Key ID 和 Secret Access Key。

第三步：在 Sync Vault 中配置

打开 Obsidian 中的 Sync Vault 设置面板，选择 S3 模式，并填入以下信息：

配置项	填写内容
Endpoint	格式为 https://<ACCOUNT_ID>.r2.cloudflarestorage.com
Region	填 auto
Bucket	填入你刚才创建的 Bucket 名称
Access Key	填入刚才获取的 Access Key ID
Secret Key	填入刚才获取的 Secret Access Key

提示：<ACCOUNT_ID> 可以在 R2 首页的右侧边栏找到。

第四步：配置 CORS (关键)

为了让桌面端和移动端能正常访问 R2，必须配置跨域资源共享 (CORS)：

1. 进入你创建的 Bucket，点击 Settings 选项卡。
2. 找到 CORS Policy 部分，点击 Add CORS policy。
3. 填入以下 JSON 配置：

[
  {
    "AllowedOrigins": [
      "app://obsidian.md",
      "capacitor://localhost",
      "http://localhost"
    ],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"]
  }
]

4. 保存设置。

---

配置完成后，点击 Sync Vault 的“测试连接”，连接成功后即可开启无限云端存储之旅。