共计 4047 个字符,预计需要花费 11 分钟才能阅读完成。
要确认 CDN 和 WAF 之后的客户端地址,先把两件事分开:TCP 连接的对端地址,以及 HTTP 头里声明的地址。应用直接看到的对端地址通常来自上一跳代理,不等同于终端用户;头里的地址又可能被客户端伪造。只有同时满足“源站只接受已知 CDN/WAF 回源”和“已核对每一跳如何写入、追加或覆盖转发头”,头里的地址才可作为判断依据。否则应回退到对端地址并告警。
这个场景常见于源站前面有 CDN、WAF、负载均衡和 Nginx 等多层入口。业务要按客户端 IP 做限流、审计、风控或地域判断时,如果直接取第一个转发头,可能把攻击者自填的地址当成客户端;如果只看 TCP 对端,又只能看到代理地址。下面给出一套以证据链为中心的核查方法,不依赖某个厂商的固定字段。
先画出请求路径和信任边界
把链路写成:客户端 → CDN 边缘 → WAF → 源站入口代理 → 应用。每一跳都问三个问题:谁建立 TCP 连接;谁写入客户端地址;后一跳是追加、覆盖还是原样透传。这里的“客户端地址”指请求到达边缘时看到的公网出口地址,不等同于终端设备在局域网内的地址;经过 NAT 时,它也可能是 NAT 出口。
信任边界从源站开始定义:源站防火墙或安全组只允许已知 CDN/WAF 回源地址访问;源站入口代理只信任这些来源发来的转发头;应用只信任入口代理写入的内部头。若源站可以被公网直连,或者回源地址段没有限制,那么任何客户端都能自带转发头,后续解析再精细也无法证明地址真实。
用请求 ID 对齐三层日志
建议在 CDN/WAF、源站入口代理和应用日志中记录同一个请求 ID,并记录:TCP 对端地址、完整的转发头、请求时间、Host 和路径。应用侧不要记录完整 Cookie、Authorization 或含个人数据的请求体。日志字段示例(未执行示例):
字段模板:ts、req_id、peer、xff、forwarded、x_real_ip、host、path
此处只列字段,不提供真实访客数据。
用请求 ID 找到同一次请求在三层中的记录,观察头字段是边缘新增、源站代理追加,还是被覆盖。只比对一条正常请求不够,还要从直连源站和经 CDN/WAF 两条路径分别发起测试,比较差异。这里说的是方法,不代表已经执行过测试;实际结果取决于当前配置。
不要默认第一个转发地址可信
可能遇到 X-Forwarded-For、Forwarded、X-Real-IP 或厂商专用客户端 IP 头。字段是否存在、由谁写入、是否允许多值,必须以对应产品和当前配置为准。通用风险是:客户端可以自带同名头;如果边缘没有清洗,源站又直接读取,就会把伪造值带入。
在“每个可信代理都向列表右侧追加上一跳地址”的模型下,可以从右向左跳过可信代理地址,取第一个不可信地址。但这个前提必须核实:有的实现覆盖而不是追加,有的把地址放在左侧,有的只写专用头。未确认追加方向前,不要套用“取第一个”或“取最后一个”的固定规则。
应用侧采用可回退的解析策略
建议把解析逻辑放在统一的入口代理或应用中间件中,而不是散落在各业务代码。步骤可以是:先取 TCP 对端;若对端不在可信代理集合,直接使用对端并标记“不可信转发头”;若对端可信,再解析转发头;若头缺失、格式错误或解析后仍全是可信代理,回退到对端并记录告警。下面只是未执行示例,且假设已经确认代理向右追加:
"""Article example: X-Forwarded-For IP literals with explicit trusted proxies."""
from ipaddress import ip_address, ip_network, IPv6Address
def normalize_ip(value):
address = ip_address(value.strip())
if isinstance(address, IPv6Address) and address.ipv4_mapped:
return address.ipv4_mapped
return address
def client_ip(peer, x_forwarded_for, trusted_cidrs):
"""peer must come from the socket, never from an HTTP header."""
peer_ip = normalize_ip(peer)
networks = [ip_network(cidr, strict=True) for cidr in trusted_cidrs]
def trusted(address):
return any(address.version == net.version and address in net
for net in networks)
if not trusted(peer_ip):
return str(peer_ip), "untrusted_peer"
if not isinstance(x_forwarded_for, str) or not x_forwarded_for.strip():
return str(peer_ip), "missing_header"
if len(x_forwarded_for) > 4096:
return str(peer_ip), "header_too_long"
parts = x_forwarded_for.split(",")
if len(parts) > 20:
return str(peer_ip), "too_many_hops"
try:
chain = [normalize_ip(part) for part in parts]
except ValueError:
return str(peer_ip), "invalid_header"
for address in reversed(chain):
if not trusted(address):
return str(address), "forwarded"
return str(peer_ip), "all_hops_trusted"
if __name__ == "__main__":
# Documentation-only networks: replace with the verified proxy ranges.
trusted_ranges = ["203.0.113.0/24", "2001:db8:100::/48"]
print(client_ip("203.0.113.9", "198.51.100.23, 203.0.113.8", trusted_ranges))
print(client_ip("192.0.2.50", "198.51.100.23", trusted_ranges))
本地示例输出如下:第一个请求的真实连接对端在可信网段内,沿转发链从右向左找到首个不可信地址;第二个请求直接来自不可信对端,因此忽略其转发头。这里只验证了解析示例,没有在本站代理链上执行。
('198.51.100.23', 'forwarded')
('192.0.2.50', 'untrusted_peer')
invalid_header、missing_header、all_hops_trusted 等结果会回退到连接对端,并返回原因,便于业务记录低置信度情况。它仅处理由已确认代理按约定追加的 X-Forwarded-For IP 字面量,不解析 RFC 7239 Forwarded、带端口地址或带方括号形式。原始头必须先符合这一约定;不能把此函数用于绕过登录、授权或 WAF。若应用服务器读到的 peer 已被其他中间件改写,应先澄清入口契约再接入。
将这段完整示例保存为 client_ip_demo.py,在本地用 python3 client_ip_demo.py 运行;只依赖 Python 3 标准库。它接收真实连接对端、X-Forwarded-For 原始字符串及可信代理网段,支持 IPv4、IPv6 与 IPv4 映射地址,按地址族匹配 CIDR,并限制头长度和跳数。文中的示例网段用于文档展示,必须替换为服务商确认的回源网段,不能把整个公网设为可信。
在代理层清洗,而不是在应用层猜
入口代理应覆盖外部传入的转发头,写入自己确认过的内部头,再交给应用。应用只读内部头,读不到就回退对端。这样即使客户端自带 X-Forwarded-For,也不会穿透到业务层。清洗规则要覆盖所有入口,包括临时调试域名、旧 IP、IPv6 入口和对象存储回源;只改主站入口会留下旁路。
源站 ACL 需要维护 CDN/WAF 的回源地址段,地址段以服务商文档和当前控制台为准。若服务商支持回源鉴权或只允许其回源,也应一并核对。这里不列出具体地址段和厂商字段,因为给定素材没有提供这些信息,列出会变成未经核实的断言。
验证清单和常见误区
可以按以下清单缩小问题:
- 从公网直连源站,带伪造转发头请求,确认源站是否拒绝或清洗。
- 经 CDN/WAF 发起请求,用请求 ID 对齐三层日志,确认头由哪一跳写入。
- 检查应用是否直接读取客户端可影响的头,是否取列表第一个值。
- 检查 IPv4、IPv6、带端口和异常格式的解析结果,确认失败时回退。
- 检查缓存命中场景:源站可能看不到请求,客户端地址需从边缘日志确认。
常见误区包括:只看 X-Real-IP 而不看它由谁设置;把 X-Forwarded-For 第一个值当客户端;CDN 到 WAF 到源站多层重复追加后仍按固定位置取值;源站安全组放行 0.0.0.0/0 却相信转发头;应用和代理各自解析一套规则。上述每一项都会让“真实地址”变成不可验证的声明。
结论
确认 CDN/WAF 后的客户端地址,本质是确认信任边界和证据链:源站不可绕过,代理层负责清洗,应用层只读可信内部头,异常时回退 TCP 对端并告警。只改一个取头字段,不能解决伪造和多层代理方向不一致的问题。
给定参考素材集中于云控制台、虚拟数据室、车端软件和 Debian 发布信息,未覆盖 CDN、WAF 或 HTTP 转发头实现;因此上文把厂商字段和代理行为列为待核实项,代码均为未执行示例。实际配置应以对应厂商文档、当前入口配置和三层日志为准。
常见问题
应用应该直接取 X-Forwarded-For 的第一个地址吗?
不应在未确认信任边界前这样做。正文建议先确认源站只接受可信代理回源、核对每跳追加或覆盖方向,再从右向左跳过可信代理取地址;头缺失或异常时回退 TCP 对端并告警。
只配置 CDN 专用客户端 IP 头是否足够?
不够。若源站可被直连,或专用头可被客户端带入,头仍不可信。需要网络层限制回源来源,并在代理层清洗或覆盖外部传入的同名头。
没有厂商文档时怎样缩小排查范围?
用请求 ID 对齐 CDN/WAF、源站代理和应用日志,记录对端地址与完整转发头,并从直连源站和经 CDN 两条路径对比。具体字段行为仍需以厂商文档和当前配置核实。