当您需要改写用户回源请求URL中的HTTP Header时,可以通过配置回源HTTP请求头参数实现。通过本文档,您可以了解配置回源HTTP请求头的操作方法。

背景信息

HTTP消息头是指,在超文本传输协议HTTP(Hypertext Transfer Protocol)的请求和响应消息中,协议头部的组件。

在HTTP消息头中,按其出现的上下文环境,分为通用头、请求头、响应头等。

HTTP消息头
说明
  • 回源请求是指用户请求中该加速域名下有通过CDN返回源站的HTTP消息。
  • 回源HTTP请求头的配置只会影响通过CDN回源的HTTP消息,对于CDN节点直接响应给用户的HTTP消息不做修改。
  • 目前不支持泛域名设置。

操作步骤

  1. 登录CDN控制台
  2. 在左侧导航栏,单击域名管理
  3. 域名管理页面,单击目标域名对应的管理
  4. 在指定域名的左侧导航栏,单击回源配置
  5. 单击回源HTTP请求头(新)
  6. 回源HTTP请求头(新)页签,单击添加
  7. 配置回源HTTP请求头信息。
    注意 当不同的操作方式同时作用于同一个回源请求头参数的时候,将会存在操作冲突的情况。此时按照操作类型的优先级来执行,优先级顺序为替换 > 增加 > 变更/删除。例如:当增加和删除操作同时作用于同一个参数时,会先增加,再删除。
    • 增加请求头参数HTTP请求头信息
      配置项 示例 说明
      请求头操作 增加 在回源HTTP请求中增加指定的请求头参数。
      自定义请求头参数 自定义请求头 可以选择在配置弹窗中已经预制的请求头参数,也可以在下拉框里选择自定义请求头,配置自定义请求头参数。
      自定义请求头名称 x-code 自定义请求头名称为x-code。
      请求头值 key1 一个请求头参数里面,可以配置多个值,不同值之间用逗号(,)隔开。
      key1, key2
      是否允许重复 允许 是否允许重复设置为允许时,可以添加重复的请求头参数。例如:x-code:key1x-code:key2
      不允许 是否允许重复设置为不允许时,添加同一个请求头参数,后面添加的值会覆盖前面添加的值。例如:先添加x-code:key1后,再添加x-code:key2,最终的值为x-code:key2
    • 删除请求头参数删除
      配置项 示例 说明
      请求头操作 删除 删除所有与请求头参数名称匹配的参数值,无论是否有重复的请求头参数。
      自定义请求头参数 自定义请求头 可以选择在配置弹窗中已经预制的请求头参数,也可以在下拉框里选择自定义请求头,删除自定义请求头参数。
      自定义请求头名称 x-code 自定义请求头名称为x-code。
    • 变更请求头参数变更
      配置项 示例 说明
      请求头操作 变更 当请求头参数不存在重复时,可以正常变更参数,有多个重复请求头参数的情况下,不允许进行变更操作。
      自定义请求头参数 自定义请求头 可以选择在配置弹窗中已经预制的请求头参数,也可以在下拉框里选择自定义请求头,变更自定义请求头参数。
      自定义请求头名称 x-code 自定义请求头名称为x-code。
      请求头变更为 key1, key3 一个请求头参数里面,可以配置多个值,不同值之间用号(,)隔开。
    • 替换请求头参数替换
      配置项 示例 说明
      请求头操作 替换 当请求头参数不存在重复时,可以正常替换参数,有多个重复请求头参数的情况下,不允许进行替换操作。
      自定义请求头参数 自定义请求头 可以选择在配置弹窗中已经预制的请求头参数,也可以在下拉框里选择自定义请求头,变更自定义请求头参数。
      自定义请求头名称 x-code 自定义请求头名称为x-code。
      查找 key 正则表达式查找需要替换的参数值。
      替换为 abc 正则表达式替换需要替换的参数值。
      匹配 匹配所有 匹配选项设置为匹配所有时,所有被匹配的值都会被替换。例如:x-code:key1,key2,key3,正则匹配值key替换为abc,替换后的结果为x-code:abc1,abc2,abc3
      仅匹配第一个 匹配选项设置为仅匹配第一个时,只有第一个被匹配的值会被替换。例如:x-code:key1,key2,key3,正则匹配值key替换为abc,替换后的结果为x-code:abc1,key2,key3
  8. 单击确定