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

设置重定向回源

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

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

我的收藏

设置重定向回源规则后，当请求的对象在桶中不存在时，TOS 将返回重定向地址给请求方，请求方再通过重定向的地址获取对象。本文介绍如何设置重定向回源。

访问流程

重定向回源的访问流程如下图所示。

注意事项

类别

注意事项

回源对象大小

重定向回源最大能够支持 300GiB。

回源条件

只有当 GetObject 且返回的 HTTP 状态码为 404 时，才会触发重定向回源。

操作步骤

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

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

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

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

    参数

    说明

    回源方式

    选择重定向回源。

    回源条件

    按需求选择触发的回源条件，触发回源需同时满足配置的所有回源条件。回源条件说明如下:

    • HTTP状态码：默认勾选且仅支持 HTTP状态码为 404。
    • 文件名前缀：勾选后设置需要触发的文件名前缀。
    • 文件名后缀： 勾选后设置需要触发的文件名后缀。

    说明

    • 例如您勾选了文件名前后缀并分别设置为 test 和 object.png，当您访问存储桶下的 test***object.png 对象不存在且返回的 HTTP 状态码为 404 时，TOS 会提供规则中设置的回源地址供您访问。
    • 勾选文件名前后缀后，您需要设置相应的信息，该条件才会生效；不填则表示不会匹配。
    • 如果您想匹配前缀下的所有后缀名，只需要勾选文件名前缀；或者勾选文件名后缀后不设置任何信息。

    指定来源域名回源

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

    注意

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

    回源地址

    设置回源条件触发后需要跳转的回源地址，说明如下：

    • 添加前后缀：触发回源规则后，将跳转至指定前后缀的文件，文件地址说明如下：
      1. 协议：必填，可选 http 或 https，默认为 http。
      2. 域名：必填，必须为域名格式，不支持 IP 地址。
      3. 文件名前缀：选填，不填则默认跳转至相应域名。
      4. 文件名后缀：选填，不填则默认跳转至相应域名。
        图片
    • 跳转固定地址：触发回源规则时，默认全部跳转至固定的文件。固定地址说明如下：
      • 协议：必填，可选 http 或 https，默认为 http。
      • 回源域名：必填，必须为域名格式，不支持 IP 地址。
    • 替换文件名前缀：触发回源规则时，跳转至替换文件名前缀的文件。说明如下：
      • 协议：必填。可选 http 或 https，默认为 http。
      • 回源域名：必填，必须为域名格式，不支持 IP 地址。
      • 替换前缀：选填。不填写替换后的前缀字段时，相当于截断；不填写替换前的文件名前缀时，相当于添加文件名前缀。

    注意

    • 只支持添加 1 个重定向地址。
    • 如果您选择跳转固定地址，则不支持拉取文件等操作。
    • 设置完成后，您可以参考回源地址区域下方的回源获取文件地址，确认回源地址是否设置正确。

    回源是否携带请求参数

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

    是否回源拉取文件

    开启后，TOS 会先重定向到源站地址，然后后台异步地将文件拉取到 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. 单击提交。
    重定向规则创建完成后，您可以在策略列表中查看已创建的规则。

其他操作

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