ProxyAddHeaders是Apache mod_proxy的开关指令，仅控制是否自动添加X-Forwarded-For、X-Forwarded-Host、X-Forwarded-Server三个标准头，值为On/Off，不支持自定义头注入；加自定义头须用mod_headers配合RequestHeader指令。
ProxyAddHeaders 是什么，它默认做什么
ProxyAddHeaders 是 Apache mod_proxy 提供的一个开关指令，控制是否自动向转发给后端的请求中添加 X-Forwarded-For、X-Forwarded-Host、X-Forwarded-Server 这三个头。它的值只能是 On 或 Off，**不负责添加自定义头**，也不接受键值对配置。
很多人误以为开启它就能注入任意字段（比如 X-Real-IP 或 X-Client-Country），其实它只做三件事：记录原始客户端 IP、当前 Host 和本机 Server 名。要加自定义头，必须用 mod_headers 配合 RequestHeader。
真正加自定义客户端信息，得靠 RequestHeader + mod_headers
Apache 不允许在 ProxyPass 指令里直接写 header 注入逻辑。正确路径是：确保 mod_headers 已加载 → 在 ProxyPass 所在作用域（VirtualHost 或目录块）里用 RequestHeader 设置。
-
RequestHeader set X-Real-IP "%{REMOTE_ADDR}e"—— 把真实客户端 IP 写入X-Real-IP -
RequestHeader set X-Forwarded-Proto "https" env=HTTPS—— 只在 HTTPS 请求时设协议头 -
RequestHeader set X-Client-Region "ap-southeast-1" early——early确保在 proxy 处理前就生效（避免被覆盖）
注意：RequestHeader 的执行顺序依赖于 early / on_success / always 修饰符；不加修饰符时，默认行为可能被后续模块覆盖，尤其在启用 mod_security 或复杂 rewrite 场景下。
常见踩坑点：头被覆盖、不生效、环境变量取不到
以下问题高频出现，且排查困难：
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
RequestHeader set写在httpd.conf全局区，但ProxyPass在VirtualHost里 —— 作用域不匹配，头根本不会发往后端 - 用了
%{HTTP:X-Forwarded-For}e想读上游传来的值，结果返回空 ——%{HTTP:xxx}e只能读原始请求头，而X-Forwarded-For往往已被mod_proxy覆盖或追加过，应改用%{REMOTE_ADDR}e更可靠 - 启用了
ProxyPreserveHost Off却还试图用%{HTTP:Host}e—— Host 头此时已被重写，取到的是后端目标地址，不是原始 Host - 没确认
mod_headers是否已LoadModule，错误日志里只报 “Invalid command 'RequestHeader'”，不提示缺模块
验证自定义头是否真发到了后端
最直接的办法是让后端服务（比如一个简单的 Node.js 或 Python Flask 接口）打印全部收到的请求头，而不是只看 curl -I 返回的响应头 —— 因为 RequestHeader 影响的是**发给后端的请求**，不是 Apache 自己返回给客户端的响应。
临时调试可用：
curl -H "X-Test-Debug: 1" http://your-apache-proxy/health
然后在后端日志里搜 X-Test-Debug 或 X-Real-IP。如果没出现，说明 RequestHeader 没生效，优先检查作用域和模块加载状态。
实际部署时，X-Real-IP 和 X-Forwarded-For 的语义容易混淆：前者应始终是直连客户端 IP（即 %{REMOTE_ADDR}e），后者是代理链路拼接值；Java 应用若用 Spring Cloud Gateway，对这两个头的解析逻辑不同，填错会导致限流或鉴权失效。
