正确做法是启用 proxypreservehost on 透传原始 host 头，使后端直接获取用户访问的真实域名（如 api.example.com）；requestheader 仅适用于添加自定义头（如 x-original-host），不可替代 host 头透传。

Apache 本身不生成“真实域名”头，它只负责透传或设置请求头。要让后端拿到用户访问的真实域名（比如 api.example.com），关键不是用 RequestHeader “传递”域名，而是确保原始 Host 头完整、未被覆盖地到达后端——这靠 ProxyPreserveHost on，而不是 RequestHeader。

RequestHeader 适合设置自定义头（如 X-Client-Domain）或补充信息，但不能替代标准 Host 头的透传逻辑。

---

✅ 正确做法：用 ProxyPreserveHost on 透传原始 Host

这是最直接、最可靠的方式：

• 默认情况下，Apache 在反向代理时会把 Host 头替换成后端地址（如 127.0.0.1:8080）；
• 启用 ProxyPreserveHost on 后，Apache 会原样转发客户端发来的 Host 头；
• 后端应用（Spring Boot、Django、Express 等）就能通过 request.getHeaders("Host") 或 req.hostname 拿到 api.example.com。

配置示例（必须与 ProxyPass 同在 <virtualhost></virtualhost> 内）：

<virtualhost>
    ServerName api.example.com
    ProxyPreserveHost on
    ProxyPass / http://127.0.0.1:8080/
    ProxyPassReverse / http://127.0.0.1:8080/
</virtualhost>

⚠️ 注意：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• 该指令不继承，每个 ProxyPass 都要单独配；
• 不能写在 .htaccess 或全局配置块外；
• 必须确保 mod_proxy 和 mod_proxy_http 已启用。

---

? 若需额外加一个自定义域名头（如 X-Original-Host）

这时才用 RequestHeader，且推荐取值自环境变量 %{HTTP_HOST}e（即原始 Host）：

RequestHeader set X-Original-Host "%{HTTP_HOST}e" early

• %{HTTP_HOST}e 是 Apache 解析后的 Host 值（等同于请求头中的 Host）；
• 加 early 保证在代理模块执行前注入，避免被覆盖；
• 后端可通过 X-Original-Host 读取，但属于冗余备份，非必需。

---

? 验证是否生效

最准的方法是让后端接口返回所有请求头，例如用一个简单 Flask 路由：

@app.route("/debug/headers")
def debug_headers():
    return dict(request.headers)

访问 https://api.example.com/debug/headers，检查响应中：

• Host 字段是否为 api.example.com（靠 ProxyPreserveHost）；
• X-Original-Host 是否存在且值一致（靠 RequestHeader）。

---

❌ 常见误区

• 用 RequestHeader set Host ... —— 无效且危险，Host 是受保护的协议头，Apache 不允许覆盖；
• 用 %{SERVER_NAME}e 或 %{SERVER_ADDR}e 取域名 —— 这些是服务器自身配置，不是客户端访问的域名；
• 把 RequestHeader 写在 <virtualhost></virtualhost> 外或不同作用域 —— 不生效；
• 依赖 X-Forwarded-Host —— 它只是可选附加头，可能为空或被伪造，不如 Host 直接可靠。

不复杂但容易忽略