如果您需要改写用户回源请求中的HTTP Header,可以通过配置回源HTTP请求头实现,支持增加、删除、变更或替换回源HTTP请求头,满足更多实际业务需求。
背景信息
HTTP请求头是HTTP的请求消息头的组成部分之一,可携带特定请求参数信息并传递给服务器。
当CDN节点请求回源站拉取资源时,源站可获取到回源请求头中携带的信息。您可以通过该功能,改写用户回源请求中的HTTP Header信息,携带特定的参数信息给源站,实现特定业务需求。例如,通过X-Forwarded-For头部携带真实客户端IP至源站。
注意事项
- 回源请求指用户请求中通过CDN回源的HTTP消息。回源HTTP请求头配置只会影响通过CDN回源的HTTP消息,对于CDN节点直接响应给用户的HTTP消息不做修改。
- 不支持对泛域名配置回源HTTP请求头。
视频点播默认支持携带以下HTTP请求头回源,您无需额外配置。
回源HTTPHeader 说明 Ali-Cdn-Real-Port 客户端与CDN节点建连时使用的真实端口。 Ali-Cdn-Real-Ip 客户端与CDN节点建连时使用的真实IP。 X-Forwarded-For 客户端请求经过CDN节点回源的整个链路上,包括客户端和CDN节点的IP信息。 X-Client-Scheme 客户端发送到CDN节点的应用层请求使用的协议,例如:HTTP、HTTPS。
操作步骤
登录视频点播控制台。
在左侧导航栏选择配置管理 > 分发加速配置 > 域名管理,进入到域名管理页面。
单击目标域名所在行的配置。
在指定域名的左侧导航栏,单击回源配置。
单击回源HTTP请求头页签。
单击添加,并配置回源HTTP请求头信息。
重要 当不同的操作方式同时作用于同一个回源请求头参数时,会存在操作冲突。此时按照操作类型的优先级来执行,优先级顺序为替换>增加>变更和删除。例如,当增加和删除操作同时作用于同一个参数时,会先增加再删除。- 增加请求头参数
配置项 示例 说明 请求头操作 增加 在回源HTTP请求中增加指定的请求头参数。 自定义请求头参数 自定义回源请求头 选择自定义回源请求头或选择已经预设好的请求头参数。
自定义请求头名称 x-code 自定义请求头名称为x-code。
请求头值 key1, key2 一个请求头参数中可以配置多个值,多个值用英文逗号(,)分隔。
是否允许重复 允许 - 允许:可以添加重复的请求头参数。例如
x-code:key1
,x-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
。
- 匹配所有:所有匹配上的值都会被替换。例如
- 增加请求头参数
单击确定,完成配置。
配置示例
示例一
配置场景:在回源头里面添加X-Forwarded-For信息,给源站传递客户端IP和中间的代理服务器IP。
以下为配置示例,当前视频点播的回源请求里面默认携带了名称为X-Forwarded-For的header,因此如果不需要修改回源请求头的名称,那么可以不用额外配置。
- 自定义请求头名称:X-Forwarded-For。
- 请求头值:$proxy_add_x_forwarded_for。
- 自定义请求头名称:X-Forwarded-For。
- 请求头值:$proxy_add_x_forwarded_for。
示例二
配置场景:在回源头里面添加客户端真实IP信息,给源站传递客户端IP地址信息。
以下为配置示例,当前视频点播的回源请求里面默认携带了名称为Ali_Cdn_Real_Ip的header,header值为客户端真实IP,因此如果不需要修改回源请求头的名称,那么可以不用额外配置。
- 自定义请求头名称:X-Real-IP。
- 请求头参数:$http_Ali_Cdn_Real_Ip。
示例三
配置场景:在回源头里面添加客户端真实端口信息,给源站传递客户端端口信息。
以下为配置示例,当前视频点播的回源请求里面默认携带了名称为Ali_Cdn_Real_Port的header,header值为客户端真实端口,因此如果不需要修改回源请求头的名称,那么可以不用额外配置。
- 自定义请求头名称:X-Real-Port。
- 请求头参数:$http_Ali_Cdn_Real_Port。