跳到主要内容

S3 接入概览

七彩云对象存储提供 兼容 S3 协议 的 API 接口，支持通过 AccessKey / SecretKey 进行认证，可用于程序开发、脚本任务以及第三方工具挂载。

接入时先确认三件事：

  • Endpoint 和 Region 是否正确
  • 当前工具或 SDK 用的是主机模式还是路径模式
  • 是否已经能稳定完成上传、下载和签名访问

API 管理页面示意

图示说明：这是 API 管理页面示意。S3 接入前，开发者通常先在这里确认密钥、接入信息和可用的开发入口。

基本连接信息​

Endpoint​

https://s3.7caiyun.com

Region​

us-west

认证方式​

AccessKey + SecretKey

AccessKey 与 SecretKey 可在控制台生成。

支持的访问方式​

七彩云对象存储同时支持两种标准 S3 访问方式：

  • 主机模式（Virtual Host Style），推荐
  • 路径模式（Path Style）

你可以根据程序、SDK 或第三方工具的兼容情况选择合适的方式。

主机模式（Virtual Host Style）​

主机模式会将存储桶（Bucket）名称作为子域名。

访问格式​

https://{bucket}-{encryptUserId}.s3.7caiyun.com/{object}

示例​

https://test-u1se2paz.s3.7caiyun.com/image.jpg

使用建议​

  • 推荐优先使用主机模式
  • 大多数 S3 SDK 默认更接近这种模式
  • 对于程序开发，通常更容易与标准 S3 接入逻辑对齐

路径模式（Path Style）​

路径模式会将存储桶（Bucket）名称放在 URL 路径中。

访问格式​

https://s3.7caiyun.com/{bucket}-{encryptUserId}/{object}

示例​

https://s3.7caiyun.com/test-u1se2paz/image.jpg

使用建议​

  • 某些第三方工具对路径模式兼容更好
  • 如遇兼容性问题，可尝试切换到路径模式
  • Alist、OpenList 等工具可能更适合用这种方式

常见接入场景​

  • 使用 SDK 上传文件
  • 脚本备份
  • 第三方工具接入
  • 自动化上传下载
  • 图片、附件和资源文件托管
  • 下载站和资源站的对象存储后端

接入前准备​

开始前可先确认：

  • 已创建可用的存储桶（Bucket）
  • 已在控制台生成 AccessKey / SecretKey
  • 已确认存储桶权限（公有 / 私有）
  • 已明确使用主机模式还是路径模式
  • 已拿到实际可用的 Endpoint 和 Region

接入顺序​

  1. 先用 AWS CLI 或其他 S3 工具验证参数
  2. 再用目标语言 SDK 完成上传和下载
  3. 如果是私有资源，再验证签名访问
  4. 最后再接业务层的权限、签名和自动化逻辑

兼容性说明​

  • 七彩云对象存储支持 HTTPS
  • 签名访问完全兼容 S3
  • 支持分片上传
  • 单文件大小不限制
  • 遇到兼容性问题时，可优先尝试切换主机模式 / 路径模式

相关页面​