必须启用proxypreservehost on，否则apache会将host头替换为后端地址（如127.0.0.1:8080），导致后端无法识别真实域名api.example.com，引发400/404/502错误、saml失败或路由异常；该指令须与proxypass同处或内，不继承、不可用于.htaccess，并需配对使用proxypassreverse修正重定向。
Apache 默认会把请求头里的 Host 替换成后端地址（比如 127.0.0.1:8080），而不是保留用户实际访问的域名（如 api.example.com）。这会让后端应用无法识别真实入口，导致 400/404/502 错误、SAML 验证失败、跳转链接出错或租户路由异常。
必须开启 ProxyPreserveHost on
这是最核心的一步。它告诉 Apache 不要重写 Host 头，而是原样转发客户端发来的原始值。
- 不加这行，后端通过
request.getHeader("Host")拿到的永远是内网地址 - 加了之后，
Host: api.example.com就能完整透传过去 - 比
X-Forwarded-Host更直接——它是标准 HTTP 头，多数框架默认信任
配置位置必须正确
该指令只在代理上下文中生效，且作用域严格受限。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 只能放在
<virtualhost></virtualhost>、<location></location>或<proxy></proxy>块内 - 必须和
ProxyPass写在同一级，不能放在全局配置或.htaccess中 - 一个虚拟主机里有多个
ProxyPass，每个都要配一行ProxyPreserveHost on，不继承
配套必须加上 ProxyPassReverse
仅透传 Host 头还不够。后端返回 302 跳转时，Location 响应头里常含内网路径，浏览器会直接请求错误地址。
-
ProxyPassReverse / http://127.0.0.1:8080/会自动改写响应头中的Location、Content-Location等 URL - 路径末尾斜杠必须严格一致：
/对应http://127.0.0.1:8080/，否则匹配失效 - 若代理路径是
/api，后端服务跑在/v1，还需额外加ProxyPassReverse /api http://127.0.0.1:8080/v1
后端也要配合解析转发头
Apache 透传了，但后端若不主动读取，依然无效。
- Spring Boot：启用
server.forward-headers-strategy=framework，确保ForwardedHeaderFilter生效 - Express（Node.js）：设
app.set('trust proxy', true)，再用req.hostname - Django：开启
USE_X_FORWARDED_HOST = True，并配好SECURE_PROXY_SSL_HEADER - Tomcat：需确认
RemoteIpValve已配置，或在代码中优先读X-Forwarded-Host
