apache反向代理下客户端真实ip丢失，本质是上游未传递x-forwarded-for头、apache未启用mod_remoteip模块解析、后端未适配转发头三环节缺失；需上游设置该头、apache配置remoteipheader与remoteipinternalproxy、后端优先读取x-forwarded-for首个有效ip。
apache 反向代理后客户端真实 ip 丢失，本质是请求经过代理层时，原始连接的客户端地址被覆盖为代理自身 ip（如 127.0.0.1 或内网地址），导致后端应用、日志、限流、白名单等功能全部失效。解决它不是单点配置，而是“上游传递 → apache 解析 → 后端读取”三环节协同。
确保上游代理正确设置 X-Forwarded-For
Apache 本身不生成 X-Forwarded-For 头，它完全依赖上游（Nginx、CDN、ALB、另一个 Apache）主动添加：
- Nginx 示例：
proxy_set_header X-Forwarded-For $remote_addr;或更安全的$proxy_add_x_forwarded_for;（保留多级链路） - 如果上游是云负载均衡（如 AWS ALB、腾讯云 CLB），需确认其已启用“转发客户端真实 IP”功能，并默认写入
X-Forwarded-For - 切勿跳过这步——没有这个头，后续所有解析都无从谈起
启用 mod_remoteip 并信任代理 IP
仅靠 RequestHeader set 或日志格式改写无法改变 REMOTE_ADDR 的值。必须用 Apache 官方模块 mod_remoteip 替换远程地址：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 确认模块已加载：
httpd -M | grep remoteip（Linux）或检查httpd.conf中有LoadModule remoteip_module modules/mod_remoteip.so - 在虚拟主机或全局配置中添加：
RemoteIPHeader X-Forwarded-For RemoteIPInternalProxy 127.0.0.1 192.168.0.0/16 10.0.0.0/8
（把实际的上游代理 IP 或网段填入RemoteIPInternalProxy，否则 Apache 拒绝信任该头） - 重启 Apache 后，
%h日志变量、request.getRemoteAddr()、PHP 的$_SERVER['REMOTE_ADDR']就会返回解析后的真 IP
后端应用必须主动兼容转发头
即使 Apache 已用 mod_remoteip 修正了 REMOTE_ADDR，部分框架（尤其是 Java Servlet）仍可能绕过它，直接读取原始连接信息：
- Spring Boot：启用
server.forward-headers-strategy=framework（2.6+），并确保X-Forwarded-For和X-Forwarded-Proto被接收 - Java Web 应用：不要只调用
request.getRemoteAddr()，应优先解析request.getHeader("X-Forwarded-For")，取逗号分隔后的第一个非空、非私有 IP - PHP：可封装一个
getRealIP()函数，按顺序检查X-Forwarded-For、X-Real-IP、REMOTE_ADDR
附带：别漏掉 Host 和协议头
真实 IP 不是唯一丢失的信息。若后端需生成绝对 URL 或判断 HTTPS，还需透传关键头：
-
ProxyPreserveHost On：让原始Host头（如app.example.com）透传，避免后端拼出http://127.0.0.1:8080这类错误链接 -
RequestHeader set X-Forwarded-Proto "https" env=HTTPS：告诉后端当前是 HTTPS 协议（尤其当 Apache 终止 SSL 时） -
RequestHeader set X-Forwarded-Port "443" env=HTTPS：补充端口信息，便于构建合规重定向
