一、功能简介
注意:EdgeOne 默认支持携带 X-Forwarded-For 和 X-Forwarded-Proto 回源,你无需再配置,详见:EdgeOne 默认回源 HTTP 请求头。
二、场景一:回源请求时携带设备类型信息至源站
例如:若你希望当前的站点域名 www.example.com 在回源时,根据客户端请求携带的 User-Agent 头部值聚合为设备类型相关头部传递给源站,可参考以下步骤配置:
1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击站点加速,进入站点全局配置页面,单击规则引擎 Tab 页。
3. 在规则引擎页面,单击创建规则,选择新增空白规则。
4. 在规则编辑页面,匹配类型选择为 HOST 等于 www.example.com。
5. 单击操作 > 选择框,在弹出的操作列表内,选择操作为修改 HTTP 回源请求头。
6. 选择类型为增加,头部名称为 EO-Client-Device 的预设头部,配置结果如下:
7. 单击保存并发布,即可完成该规则配置。
三、场景二:回源请求时通过自定义头部传递加速域名至源站
例如:若你当前的站点域名 www.example.com 已配置回源 Host 为其它域名,此时,你希望通过自定义头部 Tencent-Acceleration-Domain 将加速域名传递给源站,可参考以下步骤配置:
1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。
2. 在站点详情页面,单击站点加速,进入站点全局配置页面,单击规则引擎 Tab 页。
3. 在规则引擎页面,单击创建规则,选择新增空白规则。
4. 在规则编辑页面,匹配类型选择为 HOST 等于 www.example.com。
5. 单击操作 > 选择框,在弹出的操作列表内,选择操作为修改 HTTP 回源请求头。
6. 选择类型为增加,头部名称为 Tencent-Acceleration-Domain ,头部值为 ${http.request.host} ,配置结果如下:
7. 单击保存并发布,即可完成该规则配置。
四、相关参考
修改 HTTP 回源请求头支持的类型说明如下:
| 类型 | 说明 |
| 设置 | 变更指定头部参数的取值为设置后的值,且头部唯一。注意:若指定头部不存在,则会增加该头部。 |
| 增加 | 增加指定的头部。注意:若头部已存在,仍会增加,不会覆盖已存在头部。 |
| 删除 | 删除指定的头部。 |
支持的头部名称说明:
| 头部类型 | 说明 |
| 自定义 | 自定义头部。名称:1 – 100 个字符,由数字 0 – 9、字符 a – z、A – Z,及特殊符 – 组成。值:1 – 1000 个字符,不支持中文。 |
| 预设头部 | 根据客户端 User-Agent 信息聚合的头部:客户端设备类型:EO-Client-Device取值:Mobile,Desktop,SmartTV,Tablet 或 Others客户端操作系统:EO-Client-OS取值:Android,iOS,Windows,MacOS,Linux 或 Others客户端浏览器类型:EO-Client-Browser取值:Chrome,Safari,Firefox,IE 或 Others |
五、限制说明
·同一个修改 HTTP 请求头操作中,可添加多条不同类型操作,最多30条,执行顺序为从上至下。
·部分头部名称不支持配置,清单如下:
EO-Connecting-IPX-Forwarded-ForExpectEO-LOG-UUIDX-Tencent-Ua