EdgeOne 默认 HTTP 回源请求头
概述
默认情况下, 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:http
X-Forwarded-Proto:https
X-Forwarded-Proto:quic
CDN-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
。