边缘加速
  • 站点加速
    • 概述
    • Quickly Import and Export Site Configuration
    • 访问控制
      • Token 鉴权
    • 智能加速
    • 文件优化
      • 智能压缩
    • 网络优化
      • HTTP/2
      • HTTP/3(QUIC)
        • 概述
        • 启用 HTTP/3
        • QUIC SDK
          • SDK 概览
          • SDK 下载和集成指引
          • 代码示例
            • Android
            • iOS
          • API 文档
            • Android
            • iOS
      • IPv6 访问
      • 最大上传大小
      • WebSocket
      • 携带客户端 IP 头部回源
      • 携带客户端 IP 地理位置头部回源
      • 开启 gRPC
    • URL 重写
      • 访问 URL 重定向
      • 回源 URL 重写
    • 修改头部
      • 修改 HTTP 节点响应头
      • 修改 HTTP 回源请求头
    • 自定义错误页面
    • 请求与响应行为
      • 请求处理顺序
      • EdgeOne 默认 HTTP 回源请求头
      • EdgeOne 默认 HTTP 响应头
    • Media Services
      • Audio and Video Pre-pulling
      • Just-in-Time Image Processing
      • Just-in-Time Media Processing
      • VOD Media Origin
  • 四层代理
    • 概述
    • 新建四层代理实例
    • 修改四层代理实例配置
    • 停用/删除四层代理实例
    • 批量配置转发规则
    • 获取客户端真实IP
      • 通过 TOA 获取 TCP 协议客户端真实 IP
      • 通过 Proxy Protocol V1/V2 协议获取客户端真实 IP
        • 概述
        • 方式一：通过 Nginx 获取客户端真实 IP
        • 方式二：在业务服务器解析客户端真实 IP
        • Proxy Protocol V1/V2 获取的客户端真实 IP 格式
      • 通过 SPP 协议传递客户端真实 IP
  • 边缘 DNS
    • 托管域名 DNS 解析
      • 修改 DNS 服务器
      • 配置域名 DNS 解析记录
      • DNS 高级配置
    • 接入加速域名
      • 添加加速域名
      • 站点/域名归属权验证
      • 修改 CNAME 解析
    • 别称域名
      • 概述
      • 配置指南
      • 通过别称域名批量接入 SaaS 建站域名
      • 别称域名实现业务的容灾
    • 流量调度
      • 流量调度管理
    • 源站配置
      • 回源配置
        • 配置回源 HTTPS
        • Host Header 重写
        • 回源请求参数设置
        • 回源跟随重定向
        • HTTP/2 回源
        • 分片回源
      • 负载均衡
        • 概述
        • 快速创建负载均衡实例
        • 健康检查策略介绍
        • 查看源站健康状态
        • 相关参考
          • 负载均衡相关概念
          • 请求重试策略介绍
      • 源站组操作指引
      • 相关参考
        • 旧版源站组兼容相关问题
      • 获取 EdgeOne 回源节点 IP
  • 边缘缓存
    • 概述
    • EdgeOne 缓存规则介绍
      • EdgeOne 内容缓存规则
      • 缓存键（Cache Key）介绍
      • Vary 特性
    • 缓存配置
      • 自定义 Cache Key
      • 节点缓存 TTL
      • 状态码缓存 TTL
      • 浏览器缓存 TTL
      • 离线缓存
      • 缓存预刷新
    • 清除和预热缓存
      • 清除缓存
      • 预热缓存
    • 如何提高 EdgeOne 的缓存命中率
  • 规则引擎
    • 概述
    • 规则引擎支持的匹配类型与操作
    • 规则管理
    • 变量
Docs Overview/
边缘加速/
站点加速/
修改头部/
修改 HTTP 回源请求头/

修改 HTTP 回源请求头

功能简介

Edgeone 节点回源时，若源站需要通过 HTTP 请求头获取某些特定的信息用于业务逻辑判断或者数据分析，例如：客户端设备类型、提供加速服务的厂商。可以通过自定义设置/增加/删除 HTTP 回源请求头（节点回源站方向）来实现，其中头部值支持变量，详情请参见 EdgeOne 预设变量。

74b09faad77111ed8c12525400c56988.png


说明：
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. 登录 边缘安全加速平台控制台，在左侧菜单栏中，单击站点列表，在站点列表内单击需配置的站点。
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条，执行顺序为从上至下。