用 Blob0 连接 Cloudflare R2

将 R2 存储桶连接到 Blob0 macOS 桌面客户端：创建限定存储桶的凭据，填写 S3 API endpoint，测试连接并保存配置。

适用于公开 macOS 版 0.1.0。下方字段与按钮保留安装包中的英文名称，便于对照。核对日期：2026-10-10。

1. 准备 R2 存储桶

在你的 Cloudflare 账户启用 R2，然后在 R2 object storage 选择已有存储桶，或创建一个新桶。记下准确的桶名及所属账户。用 Blob0 管理文件不需要开启存储桶公开访问；存储及 API 用量费用按你的 Cloudflare 套餐计算。

在 R2 总览的 API Tokens 旁点击 Manage，根据账户权限创建 Account API token 或 User API token。
日常文件管理请选择 Object Read & Write，并限定到本次连接的存储桶。只浏览和下载时可选 Object Read only；该权限无法上传或修改对象。
将确认页的 Access Key ID 和 Secret Access Key 安全保存。Secret 只显示一次。Blob0 需要这一对 S3 凭据，不是通用 Cloudflare API token 的值。

首次启动时使用连接表单；之后添加其他桶，可打开侧栏齿轮 Settings → Connections → Add connection。

从 Cloudflare 复制 S3 API endpoint。默认管辖区域的 endpoint 格式如下：

https://<ACCOUNT_ID>.r2.cloudflarestorage.com

如果存储桶采用 EU、US 或 FedRAMP 管辖区域，请复制 Cloudflare 显示的对应区域 endpoint。不要在地址后添加桶名，也不要把 r2.dev 地址或公开自定义域名当成 API endpoint。

3. 填写 Blob0 连接表单
应用字段	填写内容
Connection name	本地连接名称，例如 Personal R2，不会修改云端桶名。
S3 API endpoint	你的 R2 账户提供的 HTTPS endpoint，见上方说明。
Bucket	准确的存储桶名称，不包含 URL 或文件夹前缀。
Region	auto：R2 的 SDK 配置值，也是 Blob0 的默认值。
Access Key ID	创建 R2 令牌后确认页显示的 Access Key ID。
Secret Access Key	同一组凭据中的 Secret Access Key，不要带额外空格。
Public / custom domain	可选。私有访问可留空；只有已配置公开域名、需要文件直链时才填写。这一字段不用于连接认证。

点击 Test connection。Blob0 会列出桶根目录，不上传或删除对象。成功结果以 Connected — 开头，显示本次返回的根目录条目数；空桶显示 0 items 也是正常结果。

测试成功后点击 Add connection，Blob0 会保存配置并连接到桶。之后可通过侧栏连接菜单切换已保存的存储桶。访问密钥保存在 macOS 钥匙串中，配置文件只保存非敏感元数据。

成功列出目录只证明读取与列举权限，不代表写入权限可用。需要上传或修改时请使用限定桶范围的读写令牌。可选的传输检查应使用自己桶中的小型临时文件，完成后清理。

AccessDenied 或 403: 检查令牌是否有效、是否包含目标桶，以及是否属于 endpoint 中的账户。如果能浏览但不能上传，请检查 Object Read & Write 权限。
NoSuchBucket 或 404: 核对准确桶名、账户 endpoint 和管辖区域。Bucket 字段应填名称，不是 URL。
SignatureDoesNotMatch: 重新填写配套的密钥，去除多余空格；使用 Region auto 和正确的 S3 endpoint，并确认 Mac 系统时间准确。
连接或网络错误: 检查网络是否正常、代理或防火墙是否阻断 R2 endpoint。公开域名与 S3 API endpoint 是两个不同的字段。
看不到对象: 根目录为空可能是正常情况。确认选中的桶，再打开文件夹前缀查看。测试结果不是整个桶递归统计的对象总数。

仍有问题时，请向支持提供 Blob0 版本和错误信息，并在日志、截图中遮盖访问密钥、许可码及带签名的分享链接。若 Secret 已泄露，请在 Cloudflare 撤销该令牌并重新创建。