文档

配置回源301/302跟随

更新时间:

回源301/302跟随功能同时支持源站的301和302响应状态码,本文中所有302状态码可以实现的功能,301状态码也同样支持。配置回源301/302跟随功能后,CDN节点会代替用户直接处理源站响应的301/302状态码的内容,减少数据交互流程,加快用户获取资源的速度。

前提条件

用户源站使用了301/302重定向方式去实现业务逻辑。

背景信息

301/302是HTTP协议中的一个状态码,代表已存在的资源被临时改变了位置,导致用户无法访问到对应的资源。基于此情况,服务器通常会在消息响应头中加入Location参数,当客户端接收到带有Location头的301/302响应时,会跳转到Location对应的地址去请求资源。

工作原理

回源301/302跟随功能指CDN节点回源请求资源时,如果收到源站返回的301/302状态码,将由CDN节点代替用户直接处理301/302状态码的内容,即直接跳转到源站301/302响应中的Location地址去获取资源,不会直接返回301/302状态码给用户。

image

  1. 用户向CDN节点请求访问http://example.com/examplefile.txt文件。

  2. CDN节点上未缓存该文件,CDN节点回源站请求该文件。

  3. 源站收到请求后,向CDN节点返回301/302状态码,Location地址指向http://www.example.org/examplefile.txt

  4. CDN节点收到源站的响应后,直接向Location地址http://www.example.org/examplefile.txt发起请求。

  5. CDN节点获取到所需资源后,缓存到CDN节点上。

  6. CDN节点将获取到的资源返回给用户。

此时,如果其他用户再请求访问http://example.com/examplefile.txt文件,会直接在CDN节点命中缓存并返回给用户。

注意事项

配置回源301/302跟随之前,请先确认CDN是否配置了默认回源HOST或者指定源站回源HOST

  • 加速域名既没有配置默认回源HOST,也没有配置指定源站回源HOST:当源站响应“301/302状态码+Location URL”给CDN节点时,加速域名回源请求Location URL携带的HOST头是源站响应的301/302信息里面的Location域名。

  • 加速域名配置了默认回源HOST:当源站响应“301/302状态码+Location URL”给CDN节点时,加速域名回源请求Location URL携带的HOST头是CDN上给加速域名配置的HOST头;如果客户源站的Location URL要求回源HOST必须使用Location域名,这时候访问结果就不符合预期,如果客户有该场景需求,需要使用指定源站回源HOST功能来配置。

  • 源站响应给CDN节点的Location头部的格式支持以下3种:

    • Location: http://www.example.net/index.htmlCDN节点的跟随请求将会使用Location中的完整URL。

    • Location: //www.example.net/index.htmLCDN节点的跟随请求将会使用302前的回源协议加上Location里面的信息来拼接成一个URL。

    • Location: /index.htmlCDN节点的跟随请求将会使用302前的回源协议和域名加上Location里面的信息来拼接成一个URL。

操作步骤

  1. 登录CDN控制台
  2. 在左侧导航栏,单击域名管理
  3. 域名管理页面,单击目标域名对应的管理
    域名管理
  4. 在指定域名的左侧导航栏,单击回源配置

  5. 配置页签,找到回源301/302跟随

  6. 打开回源301/302跟随开关。

  7. 配置回源301/302跟随。

    参数

    描述

    301/302跟随次数上限

    指在一次用户请求过程中,CDN节点可以跟随Location地址跳转访问的最大次数,超出限制将直接返回301/302状态码给用户。默认值为2,取值范围为1~5。

    说明

    配置301/302跟随次数上限,会影响回源次数上限。回源次数上限指在一次用户请求过程中,CDN节点可以回源访问源站的最大次数。

    回源次数上限=301/302跟随次数上限+1,即默认的回源次数上限为3,取值范围为2~6。

    301/302跟随保留参数

    • 保留:301/302跟随时保留原请求参数回目标源站。如果您选择保留,那么请求参数将会传递给Location地址对应的服务器。

    • 不保留:301/302跟随时不保留原请求参数回目标源站。

    301/302跟随保留请求头

    • 保留:301/302跟随时保留原请求头回目标源站。如果您选择保留,那么请求头参数将会传递给Location地址对应的服务器。

    • 不保留:301/302跟随时不保留原请求头回目标源站。

  8. 单击确定,完成配置。

配置示例

配置场景:您源站的资源挪至其他地址,但您并不希望您的用户感知该变动,希望使用原有域名正常访问资源。

配置方式:域名example.com开启回源301/302跟随,配置如下:回源

结果说明:用户请求http://example.com/examplefile.txt文件,恰好CDN节点为未缓存,返回源站请求资源(保留原请求参数和请求头),源站收到请求后,向CDN节点返回301/302状态码,并给出重定向地址为http://www.example.org/examplefile.txt

  1. CDN节点收到301/302状态码后,直接向重定向地址发起请求(301/302跟随次数上限设置为2,表示可以请求两次,请求失败后返回301/302状态码给用户)。

  2. CDN节点获取资源,返回给用户,并缓存至CDN节点。

  3. 其他用户再请求http://example.com/examplefile.txt文件,CDN直接将已缓存资源返回给用户。