You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

设置镜像回源

最近更新时间：2024.01.26 11:56:20

首次发布时间：2024.01.26 11:56:20

我的收藏

设置镜像回源功能后，当请求的对象在桶中不存在时，TOS 将从指定的源站拉取该文件，返回给请求方的同时将该文件写入到桶中。本文介绍如何设置镜像回源。

访问流程

镜像回源的访问流程如下图所示。

注意事项

类别

注意事项

回源对象大小

  • 镜像回源最大能够支持 5GiB 的对象。如果需要请求超过 5GiB 的对象，请使用 Get Range 的功能。
  • 使用匿名用户（例如使用Get Object）触发镜像回源时，如果存储桶设置了服务端加密，匿名用户没有 KMS 密钥权限，导致文件无法写入到存储桶，镜像回源失败，同时会产生预期外的流量费用。

回源条件

只有当 GetObject 且返回的 HTTP 状态码为 404 时，才会触发镜像回源，从源站拉取文件。

操作步骤

  1. 登录对象存储控制台。

  2. 在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

  3. 在左侧导航栏，选择基础设置 > 回源设置，在回源设置页面，单击创建规则。

  4. 在创建回源规则页面，配置如下参数。

    参数

    说明

    回源方式

    选择镜像回源。

    回源条件

    当前仅支持 HTTP状态码404。

    指定来源域名回源

    指定访问源站的域名，指定后，仅该域名可以访问源站触发镜像回源。

    注意

    • 最多指定 20 个来源域名。
    • 域名需要能访问到存储桶，建议填写存储桶绑定的自定义域名。

    回源地址

    • 协议：可选 https 或 http。
    • 域名：必须为域名格式，不支持 IP 地址。

    说明

    • 单击添加字段，可继续添加回源地址。最多支持 5 个回源地址。
    • 如果您设置了多个地址，会随机选择一个地址发送请求。如果该地址请求失败，TOS 会自动选择其他地址重试。

    是否携带请求参数

    是否将请求携带的 queryString 透传至源站。默认打开。

    是否跟随源站重定向

    是否跟随源站的 3XX 重定向请求回源，最多可重定向 1 次。默认关闭。

    HTTP Header 传递规则

    TOS 在访问指定的源站时，允许传递的响应头。支持以下规则：

    • 透传所有 HTTP Header：默认值，选择后透传所有参数，但以下请求头不会透传：Host、Content-length、Date、Authorization。
    • 透传指定 HTTP Header：指定允许传递的 Header，最多可添加 10 个。
    • 禁止透传所有 HTTP Header：选择后禁止透传所有参数。
    • 禁止透传指定 HTTP Header：指定禁止传递的 Header，最多可添加 10 个。

    新增指定HTTP Header

    指定 HTTP Header 的 Key 和 Value，指定后，会在 Header 中添加该 Key 和 Value，并透传到源站。

    注意

    • 最多指定 10 个HTTP Header。
    • 不支持指定 Content-Length、Date、Range、Authorization 类型的 Header。

  5. 单击提交。
    镜像回源规则创建完成后，您可以在策略列表中查看已创建的规则。

相关操作

  • 编辑回源规则：单击目标规则操作列的编辑，即可修改回源规则。
  • 删除回源规则：单击目标规则操作列的删除，在弹出的对话框中单击确定，即可删除回源规则。
  • 上移/下移回源规则：选择目标规则操作列的 ... > 上移或者 ... > 下移，即可调整回源规则顺序。