用 Blob0 连接 Amazon S3
在 Mac 上用 Blob0 连接 Amazon S3 存储桶：核对 endpoint 与地区，填写访问凭据，测试连接，并排查常见的权限、签名和区域错误。
已有 S3 存储桶时，使用对应区域的 API endpoint 和获授权的访问密钥，就能在 Mac 上浏览和管理对象。以下步骤对应 Blob0 0.2.0 的连接表单。
安装 Blob0 macOS 版连接前的准备
- 在 S3 控制台确认完整桶名和 AWS 地区。本教程的示例桶为 example-documents，地区为 us-west-2（Oregon）；请替换成自己的配置。
- 向 AWS 管理员取得对目标存储桶有权限的 Access Key ID 和 Secret Access Key。列举、读取、上传、删除分别需要相应授权。
- 按工作需要保持存储桶私有。通过 S3 API 连接不需要网站 endpoint 或公开自定义域名。
Blob0 当前接收访问密钥对，连接表单没有 session token 字段，也没有 AWS SSO 登录。如果组织要求 STS 临时凭据或 SSO，请使用经过组织批准且支持相应认证流程的客户端。
连接字段
首次启动时使用连接表单；已有工作区时，打开 Settings → Connections → Add connection。先在 Provider 选择 Amazon S3，再填写其他字段。
下面以 us-west-2 地区的存储桶为例。请替换桶名与凭据；示例不包含可用访问密钥。
| 字段 | 填写内容 |
|---|---|
| Provider | Amazon S3 |
| Connection name | 本地显示名称，例如 Work documents |
| S3 API endpoint | https://s3.us-west-2.amazonaws.com |
| Bucket | example-documents，只填桶名，不带 s3:// 或文件夹路径 |
| Region | us-west-2，填写桶的真实地区，不使用 R2 的 auto |
| Access Key ID | 获得授权的 AWS 访问密钥 ID |
| Secret Access Key | 与该 Access Key 对应的密钥，保存在 macOS 钥匙串 |
| Public / custom domain | 可选，私有存储桶可以留空 |
Amazon S3 预设使用 virtual-hosted 寻址，不显示 path-style 开关。上面的 endpoint 是地区 API 主机；请求时由 Blob0 加入桶名。其他地区需要对应的 endpoint，切换服务商后请一起核对 endpoint 和 Region。
测试、保存并检查第一个文件
点击 Test connection
Connected 成功提示用于检查列举访问。失败时配置尚未保存，可以修正字段后重试。桶根目录为空也可能是正常结果。
点击 Add connection
保存配置并连接。在 Settings 中确认当前使用刚保存的连接，随后应能看到桶根目录的对象与文件夹前缀。
检查实际需要的权限
获得授权后，向测试前缀上传一个小型临时文件，等待传输完成，再下载并核对内容。结束后仅删除这个测试对象。列举测试通过并不代表上传、下载、删除权限都可用。
连接失败时怎么检查
- AccessDenied
- 请桶管理员核对当前操作需要的 IAM 权限和桶策略。使用 AWS KMS 加密时可能还需额外权限。不要用公开存储桶来替代正常授权。
- SignatureDoesNotMatch
- 确认 Access Key 与 Secret 属于同一凭据，清除意外空格，并核对桶地区与 API endpoint。同时检查 Mac 系统时间。
- 地区错误或重定向
- Region 必须与桶的真实 AWS 地区一致，endpoint 也应使用该地区的 S3 API 地址。不要把 Cloudflare R2 的 auto 地区直接填到 AWS 连接中。
- 无法访问 endpoint
- 使用 HTTPS S3 API endpoint，不使用网站地址，再检查网络、DNS、代理和防火墙。使用非标准 AWS 分区时，按 AWS 官方文档取得对应地址。
这个连接适合做什么
用 Blob0 浏览、传输、预览、整理和分享已连接桶内的对象。创建桶、管理 IAM、查看存储账单和配置 AWS SSO 仍需使用 AWS 工具。重命名和移动发生在当前桶内，不是跨桶迁移。