S3 基本了解（中国大陆）
自建 S3 用于广域网文件传输。Web 端会通过浏览器向后端签发的预签名地址直传文件，因此除了 Endpoint、密钥和桶权限外，必须正确配置桶 CORS。
左侧导航可进入各云厂商的详细配置步骤（含控制台截图）。
什么时候需要 S3
- 两台设备不在同一局域网。
- 文件较大，需要稳定的广域网中转。
- 希望文件内容存放在自己的对象存储服务中。
- 局域网直连、WebRTC 或 HTTP 直连不可用。
设置页字段
在 设置 → S3 中直接填写连接信息。各厂商的 Endpoint、Region、Path-style 以该厂商文档为准；MinIO、RustFS、AWS 等没有特殊规则的对象存储按控制台地址填写即可。
填写以下字段：
| 字段 | 说明 |
|---|---|
| Endpoint | S3 API 根地址，必须包含协议，例如 https://cos.ap-guangzhou.myqcloud.com。 |
| Region | 桶所在地域。占位示例为 us-east-1；各厂商请以控制台为准。 |
| Bucket | 用于中转和暂存文件的桶名。 |
| Access Key ID | 建议使用只授权该桶的子账号密钥。 |
| Secret Access Key | 仅在保存或测试时提交；重新编辑时可留空以保留原密钥。 |
| 路径式地址 | 兼容 MinIO、数据胶囊等服务。数据胶囊必须开启。 |
桶权限建议
建议为虾传单独创建子账号或访问密钥，并只授予目标 Bucket 所需权限：
- 上传对象（PutObject）。
- 下载对象（GetObject）。
- 列出对象（ListBucket / ListObjectsV2）。云端文件浏览器依赖该权限读取目录。
- 删除临时对象（DeleteObject）。
- 分片上传相关权限：CreateMultipartUpload、UploadPart、ListParts、CompleteMultipartUpload、AbortMultipartUpload。
不要使用主账号密钥，也不要授予无关桶的管理权限。
CORS 必配
浏览器会向对象存储域名发起跨域请求。桶 CORS 必须允许用户打开虾传 Web 时的 Origin。
示例：
https://xiachuan.net
如需支持 www 子域，请一并添加 https://www.xiachuan.net。不要填写路径，也不要在末尾加 /。
CORS 规则参考
| 项目 | 建议值 |
|---|---|
| AllowedOrigins | 虾传 Web 的实际 Origin。 |
| AllowedMethods | 至少包含 GET、PUT、POST、DELETE、HEAD。 |
| AllowedHeaders | 建议 *，或至少包含 content-type、content-md5、x-amz-*、x-amz-date、authorization。 |
| ExposeHeaders | 至少包含 ETag。 |
| MaxAgeSeconds | 可设置为 86400，减少预检请求。 |
平台详细配置
按你使用的对象存储，在左侧选择对应指南（推荐优先使用缤纷云）：
测试连接
保存配置后，建议立即点击「测试连接」。如果测试失败，请按顺序检查：
- Endpoint 是否包含协议。
- Region 和 Bucket 是否与对象存储控制台一致。
- 密钥是否有目标桶的读写与列出权限。缺少列表权限时，文件浏览器无法读取目录。
- CORS 是否包含当前 Web Origin。
- 对象存储服务是否允许公网或当前网络访问。
数据边界
使用自建 S3 时，文件内容会上传到你配置的对象存储。虾传服务端主要负责签发上传/下载地址、记录必要的任务元数据和同步状态。