S3 Compatible¶
任何实现了 S3 API 的服务都可以挂载为 Windows 驱动器。连接字段始终相同——端点 URL、访问密钥 ID、秘密访问密钥 和存储桶——因此这一份指南涵盖了整个 S3 系列服务。
其中许多服务在 RaiDrive 的Enterprise选项卡中都有各自的独立条目(Wasabi、Backblaze B2、Cloudflare R2 等)。如果存在对应的独立条目,请优先选择它——这样 RaiDrive 就会自动了解该服务的服务端点格式和区域列表。对于其他情况(包括自建服务器),请使用通用的 S3 Compatible 条目。
准备工作¶
请提前准备以下内容:
- 由该服务签发的 访问密钥 ID 和 秘密访问密钥——每个兼容 S3 的服务都在自己的控制台中提供密钥管理页面;本节中各个专属提供商页面会告诉您每个具名服务的具体位置。
- 该服务的 S3 端点 URL(见下方表格)。
- 部分服务还需要一个额外标识符——例如 Cloudflare R2 需要您的账户 ID,Oracle 需要您的对象存储命名空间。
连接¶
- 点击工具栏上的添加。
- 选择Enterprise → 对应的具名服务,如果未列出则选择 S3 Compatible。
- 对于通用条目,输入端点 URL(如该服务需要,还需输入区域)。
- 输入 访问密钥 ID 和 秘密访问密钥,然后点击存储桶字段旁的刷新按钮。
- 选择存储桶并点击连接。
手动输入存储桶
如果您的密钥不允许列出存储桶,请勾选存储桶字段左侧的复选框,直接输入存储桶名称。
服务端点参考¶
| 服务 | 服务端点格式 |
|---|---|
| Wasabi | https://s3.<region>.wasabisys.com |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
| Storj | https://gateway.storjshare.io(单一全球服务端点) |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
| Alibaba Cloud | https://oss-<region>.aliyuncs.com |
| Tencent Cloud | https://cos.<region>.myqcloud.com |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com——区域:kr、us、sg、jp、de |
| Synology C2 | https://object.<region>.c2.synology.com |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com(在您的 e2 控制台中显示) |
| Akamai Linode | https://<region>.linodeobjects.com |
| IONOS | https://s3.<region>.ionoscloud.com |
| DreamHost | https://objects-us-east-1.dream.io 或 https://s3.us-east-005.dream.io(按集群而定) |
| Leviia | https://s3.<region>.leviia.com |
| MEGA S4 | https://s3.<region>.s4.mega.io |
| MinIO(自建) | 您的服务器 URL |
| Cloudian(自建) | 您的服务器 URL |
| Ceph(自建) | 您的 RADOS Gateway URL |
| Garage(自建) | 您的服务器 URL |
| Scaleway 及其他 | https://s3.<region>.scw.cloud——通过通用的 S3 Compatible 条目连接 |
设置¶
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 端点 | 该服务的 S3 API URL | — |
| 区域 | 认证所需的区域;部分服务需要(例如 Garage、Scaleway) | 空 |
| 访问密钥 ID / 秘密访问密钥 | 该服务签发的凭据 | — |
| 存储桶 | 要挂载的存储桶(列表选择或手动输入) | — |
| 只读 | 阻止对已挂载驱动器的写入 | 关闭 |
行为与限制¶
- RaiDrive 会对能自我标识的服务器校验服务端点:MinIO、Cloudian、 Ceph 和 Garage 通过服务器响应识别;IDrive e2、Akamai Linode 和 Synology C2 通过主机名格式识别。不匹配的服务端点会被判定为 "无效的服务端点"并拒绝。
- 自建服务器(MinIO、Cloudian、Ceph、Garage)使用路径风格访问,并接受私有/自签名的 TLS 证书。
- S3 语义在所有服务上都适用:没有真正的文件夹——"文件夹"只是键前缀,因此重命名大型文件夹树相当于对该前缀下的每个对象执行复制并删除——参见 AWS:使用文件夹组织对象。
故障排除¶
| 症状 | 原因 | 解决方法 |
|---|---|---|
| "无效的服务端点" | 服务端点与所选服务不匹配 | 核对表格中的格式,或改用通用的 S3 Compatible 条目 |
| 存储桶列表为空 | 密钥无法列出存储桶 | 使用手动输入存储桶 |
| 签名/授权错误 | 该服务需要显式指定区域 | 在区域字段中填入您服务控制台里的对应值 |
| 局域网服务器出现 TLS 错误 | 具名公有服务条目上使用了自签名证书 | 改用自建条目(MinIO/Cloudian/Ceph/Garage)或 S3 Compatible |