S3 兼容存储
获取凭证并配置 S3 兼容存储的服务地址、Bucket、Region 和允许的操作。
在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 S3 兼容存储,使用 推荐配置,按目标存储服务的文档填写各字段。名称默认为 S3 兼容存储,可以在 更多设置 里修改。
获取与填写凭证
从存储服务的访问管理或该服务的管理员处获取 Access Key ID 和 Secret Access Key,分别填入 Access Key ID 和 Secret Access Key。临时身份还要把同一次签发的 Session Token 填入 Session Token(可选);使用长期密钥时留空。
为凭证授予所需 Bucket 和对象的权限。官方参考:S3 身份认证。
服务地址
只支持 HTTPS 的 443 端口。服务地址 写成 https://<主机>,不带端口和路径;在其他端口提供服务的自建存储不支持。地址带了其他端口时,表单在保存前提示「S3 凭证只支持 HTTPS 443 端口,请去掉地址中的端口」;切换到 自定义 后,协议不是 HTTPS 或端口不是 443,对应字段同样会提示。
“Bucket 子域名”方式填写 https://<bucket>.<s3-endpoint>;“Bucket 路径”方式填写 https://<s3-endpoint>。
Region
填写存储服务要求的 Region:AWS S3 填写 Bucket 所在区域;其他兼容服务以其文档或该服务的管理员提供的值为准。
Bucket
填写准确的 Bucket 名称,不带协议、域名或路径。名称长 3–63 个字符,只能包含小写字母、数字、点和连字符,首尾必须是字母或数字,不能有连续的点,点和连字符也不能相邻。
Region、Bucket、访问方式和允许的操作保存后不能修改,需要调整时重新添加凭证,见修改与替换。
访问方式
Bucket 子域名 把 Bucket 名放在主机名里;Bucket 路径 把 Bucket 名放在请求路径里。选择目标服务明确支持的方式。
允许的操作
只选择需要的操作。复选框显示的是 S3 操作名,含义如下;默认只勾选 get_object。
| 操作名 | 作用 |
|---|---|
| list_objects_v2 | 列举对象 |
| get_object | 下载对象 |
| put_object | 上传对象 |
| delete_object | 删除对象 |
| head_object | 查看对象信息 |
| head_bucket | 检查 Bucket |
这份凭证只支持上表的操作:不支持分片上传、预签名链接和对象复制,需要分片上传的大文件无法上传。
验证
保存后,请 ZAI 用一项已授权的只读操作(如 get_object)访问目标对象。遇到签名错误,先核对 Access Key ID 与 Secret Access Key 是否配对、Region 和服务地址是否正确,再核对 允许的操作 与存储服务里的账号权限。其余排查见验证与排错。