Apache反向代理需启用mod_proxy、mod_proxy_http等模块，配置ProxyPass/ProxyPassReverse实现路径转发，并添加ProxyPreserveHost、X-Forwarded头及ProxyRequests Off等安全增强项。
直接在 httpd.conf 中配置反向代理是可行的，但不推荐作为长期方案——它容易造成主配置臃肿、难以维护，且重启时风险更高。更稳妥的做法是把规则移入独立的虚拟主机文件（如 httpd-vhosts.conf），不过若环境简单或临时调试，httpd.conf 里加几行也能快速生效。
先确保代理模块已启用
Apache 默认不加载代理功能，缺模块会导致 ProxyPass 报 500 错误或“Invalid command”。打开 httpd.conf，找到并取消以下三行注释（删掉开头的 #）：
LoadModule proxy_module modules/mod_proxy.soLoadModule proxy_http_module modules/mod_proxy_http.soLoadModule proxy_connect_module modules/mod_proxy_connect.so
保存后运行 httpd -t 检查语法，再执行 httpd -M | grep proxy（Linux/macOS）或 httpd -M | findstr proxy（Windows），确认输出含 proxy_module (shared) 和 proxy_http_module (shared)。
在 httpd.conf 底部添加代理规则
不要写在 <IfModule> 块内，也不建议塞进其他指令中间。直接在文件末尾追加一个完整的 <VirtualHost> 块（哪怕只用一个端口）：
<VirtualHost *:80>
ServerName example.com
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>
关键点说明：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
ProxyPreserveHost On：让后端收到原始Host头（比如example.com），避免 Spring Boot 或 Nginx 等生成错误跳转地址 -
ProxyPass和ProxyPassReverse的路径斜杠必须严格一致——/对应http://.../，/api/就得对应http://.../api/，否则可能拼错路径导致 404 - 如果只代理子路径（如仅
/api），写成ProxyPass /api/ http://127.0.0.1:3000/api/即可，其余请求仍由 Apache 自己处理
补充必要安全与功能头
仅转发还不够，后端常需知道真实客户端 IP 和协议类型。在同一个 <VirtualHost> 块内追加：
RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}e" earlyRequestHeader set X-Forwarded-Proto "http" env=!HTTPSRequestHeader set X-Forwarded-Proto "https" env=HTTPS-
ProxyRequests Off（防被滥用为正向代理，务必加在<VirtualHost>外或全局段）
注意：X-Forwarded-For 是传递 IP 的标准方式，但后端代码（如 Java 的 request.getRemoteAddr()）默认不解析它，需配合框架配置（如 Spring Boot 的 server.forward-headers-strategy=framework）才真正生效。
重启并验证是否生效
完成编辑后，依次执行：
-
httpd -t：检查配置语法，无报错才能继续 -
sudo systemctl restart httpd（RHEL/CentOS）或sudo apachectl restart（macOS/Linux） - 访问
http://your-server-ip/，观察是否返回后端服务内容；用curl -I http://your-server-ip/查看响应头中是否有Location被正确重写（比如没暴露127.0.0.1:8080）
实际使用中，建议尽早迁出 httpd.conf，改用 Include conf/extra/httpd-vhosts.conf 方式管理，结构更清晰，升级或排查也更省心。
