要记录真实处理请求的后端服务器 ip，需在 nginx 日志中使用 $upstream_addr 变量，该变量在 proxy_pass location 中生效，返回实际转发的 upstream 地址（如 10.0.2.5:8080），支持负载均衡与重试场景。
要在 Nginx 反向代理日志中记录**真实处理请求的后端服务器 IP**（即 upstream server 的 IP），关键不是记录客户端 IP，而是把 proxy_pass 目标的真实地址写进 access_log。Nginx 本身不直接提供“后端服务器 IP”变量，但可通过 $upstream_addr 实现——它会记录实际转发到的后端地址（含 IP 和端口），支持负载均衡场景下的多实例识别。
启用 $upstream_addr 记录后端 IP
Nginx 的 $upstream_addr 变量在请求完成（包括失败）后才填充，仅在配置了 proxy_pass 的 location 中有效。它返回格式如：10.0.2.5:8080, 10.0.2.6:8080（多台时逗号分隔），或 10.0.2.5:8080, 10.0.2.5:8080（重试时重复出现）。
- 确保日志格式定义在
http块中，使用$upstream_addr - 示例日志格式：
log_format backend_log '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$upstream_addr"'; - 在 server 或 location 中启用：
access_log /var/log/nginx/backend_access.log backend_log;
区分单后端与负载均衡场景
若只配了一个后端（如 proxy_pass http://192.168.1.10:3000），$upstream_addr 总是固定值；若用了 upstream 块（如轮询、ip_hash），它能准确反映本次请求落到哪台机器，对排查后端节点异常非常有用。
- 定义 upstream 示例：
upstream app_backend { server 192.168.1.10:3000; server 192.168.1.11:3000; } - location 中使用：
location / { proxy_pass http://app_backend; ... } - 日志中将看到类似：
192.168.1.10:3000或192.168.1.11:3000, 192.168.1.10:3000（重试后）
补充：同时记录客户端 IP 和后端 IP
常见需求是日志里既要有访客真实 IP（通过 X-Forwarded-For 传递），也要有最终处理它的后端 IP。这时可组合多个变量：
- 推荐日志格式：
log_format full_proxy '$http_x_forwarded_for - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$upstream_addr" "$upstream_http_x_real_ip"'; - 其中
$upstream_http_x_real_ip可捕获后端响应头中带的X-Real-IP（如有），用于交叉验证 - 注意：
$http_x_forwarded_for是客户端传入的原始值，应配合 Nginx 的proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;使用才可靠
验证与调试建议
配置完成后需验证是否生效：
- 执行
nginx -t检查语法，再nginx -s reload重载 - 发起一次请求（如
curl -H "X-Forwarded-For: 203.0.113.5" http://your-domain/） - 立刻查看日志：
tail -f /var/log/nginx/backend_access.log，确认字段输出完整且无破折号（-）占位 - 若
$upstream_addr显示为-，说明该请求未进入 proxy_pass 流程（比如被 rewrite 截断、匹配到其他 location）
