如何利用 $proxy_host 与 $upstream_addr 变量在多级负载均衡路径中精准审计流量的实际落点-Nginx-PHP中文网

$proxy_host表示proxy_pass配置的目标主机名（反映意图），$upstream_addr记录实际连接的后端ip:端口（体现执行结果）；前者静态、后者动态，重试时以逗号分隔多地址，需结合x-request-id与自定义日志格式实现跨层链路追踪。

如何利用 $proxy_host 与 $upstream_addr 变量在多级负载均衡路径中精准审计流量的实际落点

在多级负载均衡架构中，$proxy_host 和 $upstream_addr 是 Nginx 日志与调试中两个关键变量，它们分别记录了代理目标主机名和实际转发到的上游地址。要精准审计流量最终落点，必须理解二者差异、采集时机与组合使用逻辑。

明确 $proxy_host 与 $upstream_addr 的本质区别

$proxy_host 是 Nginx 根据 proxy_pass 指令或 resolver 解析后确定的“目标主机名”，不一定是真实 IP；而 $upstream_addr 记录的是实际建立连接的后端地址（含 IP 和端口），支持多个值（如发生重试或使用 upstream 组时会以逗号分隔）。前者反映配置意图，后者体现执行结果。

若 proxy_pass 写死为 http://10.1.2.3:8080，则 $proxy_host 为 10.1.2.3，$upstream_addr 也为 10.1.2.3:8080
若 proxy_pass 指向 upstream 块且启用了健康检查/动态 DNS，则 $proxy_host 仍为 upstream 名（如 backend），但 $upstream_addr 会显示具体选中的节点（如 10.1.2.10:8080, 10.1.2.11:8080）
当发生失败重试时，$upstream_addr 可能包含多个地址，例如 "10.1.2.10:8080, 10.1.2.11:8080"

在 access_log 中结构化记录实际落点

仅靠默认日志无法区分多级跳转路径，需自定义 log_format 显式捕获关键变量，并确保它们在每层 Nginx 实例中都被记录。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

在最外层入口网关（L7 入口）：记录 $host（原始 Host）、$proxy_host（它转发给哪组 upstream）、$upstream_addr（真正连到哪个后端）
在中间层 LB（如区域网关）：同样记录自身 $proxy_host 和 $upstream_addr，同时可添加 $http_x_forwarded_for 或自定义头传递上一级信息
推荐日志格式示例：log_format trace '$time_iso8601 | $host | $proxy_host | $upstream_addr | $upstream_http_x_request_id | $status';