客户端 IP 解析
AISIX 网关会把每个请求归属到一个客户端地址。调用方直接连接时,该地址就是连接的 TCP 对端。网关运行在负载均衡器或 Ingress 后方时,TCP 对端是前置设备,网关需要由该设备告知原始客户端是谁。本文介绍网关接受这类信息的两种方式,即 X-Forwarded-For 和 PROXY protocol,以及如何配置网关信任哪些设备提供这类信息。
客户端地址的用途
网关在所有需要识别调用方的地方都使用解析出的客户端地址:
- 用量事件的
client_source_ip字段,以及 OTLP 链路 的client.address属性。 - 模型的
allowed_cidrs、透传路由的来源允许列表,以及 MCP 的source_cidrs。 - 基于客户端 IP 的哈希路由。
访问日志还会记录连接的 peer,即连接对端的地址和源端口。
默认配置下,网关不信任前置的任何设备,客户端地址始终是 TCP 对端。