EdgeOne Logo
Documentation
请选择
请选择
Overview
Menu

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-For

X-Forwarded-Proto

X-Forwarded-Proto 用于记录客户端的请求协议,取值为当前客户端发起请求所使用的 HTTP 协议,头部取值有:
X-Forwarded-Proto:http
X-Forwarded-Proto:https
X-Forwarded-Proto:quic
更多详情请参见 X-Forwarded-Proto

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