用 Blob0 连接 MinIO
在 Mac 上用 Blob0 连接已有 MinIO 存储桶：向管理员获取 S3 API endpoint、签名 Region 和受限密钥，测试列表访问后保存连接。
本教程适用于 MinIO 服务器和存储桶已经部署的情况。Blob0 通过 S3 API 处理对象文件，不安装或管理 MinIO 服务器。
下载与安装指南连接前准备
- 准备好已有存储桶，以及 MinIO 管理员签发、限定该桶和所需操作的密钥对。Test connection 需要此密钥允许列举桶根目录。
- 向管理员获取此部署的 endpoint 和签名 Region。只有已配置直链域名时才填写可选的 Public / custom domain。
填写 Blob0 连接表单
首次启动时使用连接表单；之后添加其他桶，可打开 Settings → Connections → Add connection。在 Provider 选择 MinIO，再把下方示例替换为管理员提供的部署参数。endpoint 后不要附加桶名。
| 应用字段 | 填写内容 |
|---|---|
| 服务商（Provider） | MinIO |
| 连接名称（Connection name） | 本地显示名称，例如 Team MinIO，不会修改存储桶名称。 |
| S3 API endpoint | https://storage.example.com（仅为示例；请替换为管理员提供且这台 Mac 可访问的 S3 API URL）。不要使用 Console 地址。 |
| 存储桶（Bucket） | example-documents（仅为示例；请替换为准确的已有存储桶名称）。不要填写 URL 或文件夹前缀。 |
| 区域（Region） | 服务器签名 Region。MinIO 预设初始值为 us-east-1，请向管理员确认实际值。 |
| Access Key ID | MinIO 管理员签发、限定存储桶范围的密钥 ID。 |
| Secret Access Key | 与该 ID 配对的密钥，只在 Blob0 中填写并由 macOS Keychain 保存。 |
| 公开域名 / 自定义域名（Public / custom domain） | 可选。私有桶可留空；该字段不会影响 API 认证。 |
| 使用路径式 URL（Use path-style URLs） | MinIO 预设初始启用 path-style。除非管理员说明 endpoint 必须用 virtual-hosted 寻址，否则保持启用。 |
测试并保存连接
Test connection
点击 Test connection。Blob0 会列举所选存储桶的根目录；空桶可能显示 0 items。测试成功只证明本次列表请求成功，不代表能够读取对象内容，也不代表拥有上传、覆盖或删除权限。
MinIO 预设初始启用 path-style。如果列出的对象不符合预期，先确认桶名和密钥范围，再向管理员核对 endpoint 的寻址方式。
Add connection
测试成功后点击 Add connection，保存配置并连接。Blob0 将访问密钥保存在 macOS 钥匙串中；配置文件只保存非敏感连接信息。
可选：验证已获授权的传输操作
只有存储桶所有者同意进行写入测试时，才用新的测试名称上传一个很小的临时文件，下载并核对内容，然后删除这个测试对象。先确认桶策略和保留规则；不要拿已有对象做测试文件。
连接问题排查
- AccessDenied
- 确认密钥有效、限定到该存储桶，并允许列举桶根目录。请管理员检查适用的用户策略和存储桶策略。
- SignatureDoesNotMatch
- 确认 Access Key ID 和 Secret Access Key 属于同一密钥对、Region 与服务器签名配置一致，并检查 Mac 系统时间。
- NoSuchBucket 或 404
- 核对桶名，并确认 endpoint 指向同一套 MinIO 部署。Bucket 字段只填名称，不填 URL 或前缀。
- Endpoint 或 TLS 错误
- 确认这台 Mac 能访问 S3 API 主机和端口，且 TLS 证书受信任。Console 地址或 Console 端口不能替代 S3 API endpoint。
- 寻址或代理错误
- 除非管理员提供其他 URL 寻址方式，否则保持 path-style。请管理员检查代理是否将 S3 API 路径转发到 API 服务。