Skip to Content
控制台指南镜像回源

镜像回源

US3 提供镜像回源功能,配置回源规则后,当您向 US3 存储空间请求的数据不存在时,可以通过回源设置,对于获取数据的请求以多种方式进行回源读取,满足您对于数据热迁移、特定请求重定向的需求。

设置回源规则后,可对 US3 的每条 GET 或 HEAD 请求的 URL 按设定的规则进行匹配,然后按照设定的规则进行回源。最多配置 5 条规则,顺序匹配,直到匹配到有效规则。回源类型为镜像方式。

  • 镜像方式:如果配置了回源规则,则当对一个不存在的文件进行 GET 或 HEAD 操作时,会向源站地址请求这个文件,返回给用户,并同时写入到 US3。
  • 镜像方式下,如果请求中携带 Range 头部字段,最终会将完整的回源文件写入 US3 而非仅写入 Range 所表明的部分数据。

  • 图片处理请求不会触发镜像回源。

使用场景

您的大部分源文件存储在 US3 存储空间,少量文件在客户源站,但仍会有少量文件继续写到源站,可通过镜像回源功能直接到源站回源获取文件,从而实现业务的平滑迁移。

设置回源规则

用户指定文件前缀和源站地址,当 US3 没有文件时,US3 自动根据文件前缀到指定源站抓取文件保存,并返回给用户。

  • 选择对应空间,在右侧操作中选择镜像回源按钮。
  • 点击添加回源规则按钮。
  • 添加回源规则界面。
  • 填写文件前缀和回源地址,文件前缀为指定源站真实路径,若为根目录,则文件前缀为空。

例:通过 US3 访问其他源站 test 文件夹下的文件,设置回源规则,文件前缀为 test,回源地址为源站地址。

注:回源地址只支持 HTTP 访问

  • 通过US3访问其他源站该文件夹下的文件。
  • US3也自动保存了该文件。

备注

  1. 当前每个单地域存储空间(Bucket)下可创建 5 条回源规则,前缀唯一不可重复
  2. 全球化空间管理暂不支持设置回源规则
  3. 子账户需要开启 API 密钥权限(常见问题),若子账号未开启 API 密钥,US3 则不能将回源文件上传到用户的 Bucket
  4. 不支持在图片处理请求中触发镜像回源,即不支持图片处理的目标文件为源站中的文件(用户可先发起镜像方式下的回源请求,待回源成功后,再发起图片处理请求)
  5. 不支持源站为私有 US3 或其他第三方私有 Bucket
  6. 不支持源站地址使用 US3 内网域名
  7. 不支持 MD5 校验
  8. 若源站返回 3xx 重定向响应,US3 会向新的源站地址重新发起请求,最大递归次数为 10 次