S3 兼容性

SynapS3 主要支持 path-style S3 访问，负责把存储桶和对象数据写入 Filecoin。

客户端要求

• 使用 path-style addressing。
• 本地评估时，将客户端端点设置为 http://localhost:8080。生产 S3 流量必须使用原生 TLS 或受控的 TLS 反向代理。
• 使用 synaps3 admin s3-user create 创建的凭据。
• 对象和对象键必须符合下面的稳定限制。

稳定限制

• 对象大小：127 到 1,065,353,216 字节。
• 对象键：必须是有效 UTF-8、不得包含 NUL，并且最多 1024 字节。
• 分段上传：最多 10,000 个 parts；完整对象仍受对象大小上限约束。

操作矩阵

领域	操作	状态	说明
存储桶	CreateBucket	支持	创建存储桶。
存储桶	HeadBucket	支持	检查存储桶元数据。
存储桶	ListBuckets	支持	列出有效存储桶。
存储桶	DeleteBucket	不支持	返回 501；SynapS3 生命周期不包含删除存储桶。
存储桶	GetBucketVersioning	支持	存储桶始终按 versioning-enabled 处理。
存储桶	PutBucketVersioning	部分支持	接受 Enabled，拒绝 Suspended。
存储桶 ACL	GetBucketAcl	支持	返回已保存的存储桶 ACL。
存储桶 ACL	PutBucketAcl	支持	保存用于访问控制的存储桶 owner 和 ACL 变更。
对象 ACL	GetObjectAcl, PutObjectAcl	不支持	不要依赖对象级 ACL 状态或授权变更。
存储桶 Policy	GetBucketPolicy, PutBucketPolicy, DeleteBucketPolicy	不支持	不保存或执行存储桶 Policy。
存储桶 Tagging	GetBucketTagging, PutBucketTagging, DeleteBucketTagging	不支持	不保存存储桶 tags。
对象 Tagging	GetObjectTagging, PutObjectTagging, DeleteObjectTagging	不支持	不保存对象 tags。
Ownership Controls	GetBucketOwnershipControls	部分支持	返回 BucketOwnerPreferred。
Ownership Controls	PutBucketOwnershipControls	部分支持	只接受 BucketOwnerPreferred，拒绝其他 ownership modes。
Ownership Controls	DeleteBucketOwnershipControls	部分支持	保持 ACL 兼容的 BucketOwnerPreferred 行为。
对象	PutObject	支持	按缓存优先的写入模型存储对象。
对象	GetObject	支持	从缓存或已提交的远端存储读取。
对象	HeadObject	支持	读取对象元数据。
对象	DeleteObject	支持	不带 versionId 时创建 delete marker；带 versionId 时删除符合条件的数据版本或 delete marker。
对象	DeleteObjects	支持	对每个条目应用相同的版本删除规则，并分别返回失败结果。
对象	CopyObject	支持	源对象必须可从缓存或已提交的远端存储读取。
对象	ListObjects	支持	Marker 分页。
对象	ListObjectsV2	支持	Continuation-token 分页。
对象	ListObjectVersions	支持	列出对象版本和 delete markers。
对象	GetObjectAttributes	部分支持	返回元数据和 multipart ObjectParts，但不包含 TotalPartsCount。
分段上传	CreateMultipartUpload	支持	开始上传。
分段上传	UploadPart	支持	上传单个 part。
分段上传	UploadPartCopy	部分支持	仅支持整对象复制，不支持 range copy。
分段上传	CompleteMultipartUpload	支持	组装 parts。
分段上传	AbortMultipartUpload	支持	取消上传。
分段上传	ListMultipartUploads	支持	列出未完成上传。
分段上传	ListParts	支持	列出已上传 parts。

版本控制行为

存储桶按 versioning-enabled 处理。不带 versionId 的删除会创建 delete marker。带 versionId 的请求要么删除对应的数据版本或 delete marker，要么返回错误；系统不会保留请求并在之后自动执行。删除 delete marker 不受 Filecoin 存储进度阻塞。当存储工作仍在进行，或已提交的 Filecoin 交易仍在等待确认时，删除数据版本会收到 400 InvalidRequest，DeleteObjects 则为对应条目返回 InvalidRequest。对于其他条件均符合永久删除要求的数据版本，已停止且尚未提交交易的存储工作不会阻止删除。数据版本删除后，不再被任何版本引用的远端存储会进入后台清理；其他版本仍在使用的共享存储会保留。清理会请求存储提供方删除副本，但并非所有存储提供方都支持：提供方不支持或无法删除的副本，在该版本从网关消失后仍可能留在提供方处。清理完成前（通常几分钟内），向该存储桶上传相同内容会收到 503 SlowDown；稍后重试即可，届时会作为新数据存储。Version listing 会返回对象版本和 delete markers。

有意不支持

• 删除存储桶。
• 暂停存储桶 versioning。
• 对象 ACL 授权、存储桶 Policy，以及存储桶或对象 Tagging。
• BucketOwnerPreferred 之外的 Ownership Controls 模式。
• GetObjectAttributes.ObjectParts 中的 TotalPartsCount。
• UploadPartCopy 的 multipart range copy。
• 多个 SynapS3 节点之间的分布式协调。

验证

AWS CLI、rclone 和 MinIO Client 示例见 S3 客户端。