$proxy_host 是 Nginx 中记录实际回源目标主机名或 IP 的关键变量，仅在 proxy_pass 使用动态变量（如 http://$backend）时生效；静态 upstream 场景应改用 $upstream_addr 等替代方案。
在多级代理环境中，$proxy_host 是 Nginx 中一个关键的内置变量，它记录了当前请求实际转发到的上游服务器（即回源目标）的主机名或 IP 地址。利用它，可以实时感知和监控回源目标的动态切换行为，尤其适用于基于 upstream 模块配合健康检查、一致性哈希（hash $request_uri consistent;）、随机/轮询策略，或使用 lua-resty-upstream-healthcheck 等动态后端管理方案的场景。
确认 $proxy_host 的生效前提与取值逻辑
$proxy_host 并非始终可用，其值取决于是否真正执行了 proxy_pass 且上游地址由变量动态决定。需满足以下条件才能稳定捕获：
- 必须在
location块中使用proxy_pass指令，并且其后跟的是变量（如proxy_pass http://$backend;），而非静态 upstream 名称（如proxy_pass http://my_upstream;）——后者$proxy_host默认为空或为 upstream 名字，不可靠； - 若使用
upstream+proxy_pass http://my_upstream;，应改用$upstream_addr（含 IP:port）或配合log_format中的$upstream_http_x_backend等自定义响应头来间接推断目标； - 确保未启用
proxy_redirect default;或覆盖 Host 头导致原始目标信息丢失； - 在
log_format或access_log中直接引用该变量即可记录每次请求的实际回源地址。
通过 access_log 实时记录并分析回源目标变化
将 $proxy_host 写入访问日志是最轻量、最通用的监控方式，便于后续用 ELK、Prometheus + mtail 或简单 shell 脚本做统计分析：
- 在
http块中定义带$proxy_host的日志格式：
log_format proxy_trace '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$proxy_host" $upstream_response_time'; - 在对应
location启用该格式：
access_log /var/log/nginx/proxy-trace.log proxy_trace; - 配合
tail -f或日志采集工具，可即时观察某 URI 是否持续打向同一$proxy_host（如一致性哈希生效），或在故障转移时是否快速切换到备用节点。
结合 Lua 实现细粒度判断与告警联动
当需要在请求处理过程中主动感知、拦截异常切换或触发告警时，OpenResty 的 Lua 脚本是更灵活的选择：
- 在
access_by_lua_block中读取ngx.var.proxy_host，比对预设白名单或记录上一次值，识别“非预期切换”； - 例如：对关键接口，若
$proxy_host在 10 秒内变更超过 3 次，可调用ngx.log(ngx.WARN, "Frequent backend switch for ", ngx.var.uri)并上报至 Prometheus 的自定义指标； - 也可在
header_filter_by_lua_block中注入X-Proxy-Host: $proxy_host响应头，供下游服务或前端调试工具直接查看本次请求真实回源目标。
注意与其他变量的协同与边界情况
$proxy_host 单独使用有局限，需结合上下文变量避免误判：
- 它不包含端口，若上游集群存在同域名不同端口（如
backend1:8080,backend2:8081），应改用$upstream_addr（格式为10.0.1.2:8080）； - 若启用
proxy_set_header Host $proxy_host;，需确保后端服务能正确解析该 Host，否则可能影响路由或证书验证； - 在重试（
proxy_next_upstream）场景下，$proxy_host仅反映最终成功那次的目标，不体现失败尝试过程 —— 如需完整链路，需依赖$upstream_addr（含多次地址，以逗号分隔）。
