EdgeOne 默认 HTTP 回源请求头
最后更新时间：2025-05-26 15:28:58
概述
默认情况下， EdgeOne 在回源请求时，将透传客户端的所有请求头部，同时携带由 EdgeOne 自定义的默认请求头部回源。如果您还需要对回源的 HTTP 头部进行增删改配置，可参见 修改 HTTP 回源请求头。
默认 HTTP 回源请求头介绍
以下为 EdgeOne 在回源时，默认增加的 HTTP 请求头及含义。
EO-Connecting-IP
EO-Connecting-IP 记录了与 EdgeOne 建立连接的客户端请求 IP 地址。如果该请求未经过任何代理服务器，则该头部 IP 即为真实客户端 IP 地址，如果请求经过代理服务器，则该头部 IP 值指代理服务器的 IP 地址。X-Forwarded-For
X-Forwarded-For 用于记录代理服务器和真实客户端 IP 地址。当用户请求经过多跳到达 EdgeOne 边缘节点中时，可通过该头部来查看真实的客户端 IP 地址以及到达 EdgeOne 边缘节点的前序代理服务器地址。该头部取值如下：如果发送到 EdgeOne 的请求中携带有
X-Forwarded-For 头部，该头部已记录了最原始的访问客户端 IP 地址，则 EdgeOne 会将到达 EdgeOne 边缘节点的前序代理服务器 IP 地址追加到头部值。假设与 EdgeOne 边缘节点建连的前序代理服务器 IP 地址为 10.1.1.1，且请求时携带 X-Forwarded-For: 192.168.1.1（原始客户端 IP），则回源请求头取值为 X-Forwarded-For: 192.168.1.1,10.1.1.1。如果发送到 EdgeOne 边缘节点的请求中没有
X-Forwarded-For 头部，则 EdgeOne 将在回源请求时，增加 X-Forwarded-For 头部，该头部取值为与 EdgeOne 边缘节点建连的前序代理服务器 IP 地址，取值与 EO-Connecting-IP 头部相同。X-Forwarded-Proto
X-Forwarded-Proto 用于记录客户端的请求协议，取值为当前客户端发起请求所使用的 HTTP 协议，头部取值有：X-Forwarded-Proto：httpX-Forwarded-Proto：httpsX-Forwarded-Proto：quicCDN-Loop
CDN-Loop 用于记录当前请求经过 EdgeOne 边缘加速节点的次数，主要用于平台防止请求环路。当客户端请求每重复经过 1 次 EdgeOne 的节点时，CDN-Loop 的次数则加1，并标记到请求头中，当请求头的 Loops 数值达到 ≥ 16时，则节点将拒绝请求并响应423状态码。
该头部格式示例：
CDN-Loop: TencentEdgeOne; loops=3。EO-LOG-UUID
EO-LOG-UUID 代表了当前请求的唯一标识符，该头部主要用于当出现访问异常时，通过该头部值匹配用户请求的全链路日志来定位问题。
该头部格式示例：
EO-LOG-UUID: 4105283880544427145。EO-Bot-Tag
当启用了 Bot 管理后，平台在将请求回源时，会自动附加一个 HTTP 请求头
EO-Bot-Tag，内容为包含对请求客户端的 Bot 标签识别结果的 JSON 字符串，辅助源站进行日志分析与安全防护策略联动。详情请见 通过头部获取回源请求的 Bot 管理标签。文档反馈