mod_proxy_html专用于重写反向代理中HTML文档体内的内网链接，需依赖proxy、proxy_http、xml2enc和headers模块按序启用；先映射绝对URL再处理相对路径，禁用gzip并确保编码正确，才能使href/src全部转为可访问的代理路径。
Apache 的 mod_proxy_html 是专为解决反向代理中 HTML 内容里内网链接（如 href="/css/main.css" 或 src="http://10.5.10.200/js/app.js"）无法自动重写而设计的模块。它不是 ProxyPassReverse 的替代品，而是补充——后者只改响应头和重定向地址，mod_proxy_html 才真正解析并重写 HTML 文档体内的 URL。
必须启用且顺序正确的依赖模块
该模块不能独立运行，缺一不可：
-
mod_proxy和mod_proxy_http：基础代理能力 -
mod_xml2enc：负责识别和转换 HTML 的字符编码（比如后端返回charset=gb2312时，没它就直接跳过解析） -
mod_headers：用于清除客户端请求头中的Accept-Encoding，防止后端返回 gzip 压缩内容导致 mod_proxy_html 无法处理
启用命令示例（Debian/Ubuntu）：
a2enmod proxy proxy_http proxy_html xml2enc headersURL 映射规则的写法与执行顺序
映射不是字符串替换，而是按配置顺序逐条匹配 URL 路径前缀。顺序错误会导致链接被截断或误改。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
立即学习“前端免费学习笔记（深入）”；
- 先处理绝对 URL：
ProxyHTMLURLMap http://10.5.10.200 /lab（末尾不加斜杠，避免把/api错变成/lab/api） - 再处理相对 URL：
ProxyHTMLURLMap / /lab/（开头必须有斜杠，否则无法匹配href="css/main.css"这类路径） - 若后端用 HTTPS，也需加一行：
ProxyHTMLURLMap https://10.5.10.200 /lab
所有 ProxyHTMLURLMap 必须放在 <Location> 块内或对应 <VirtualHost> 下，不能写在 .htaccess 中。
绕过 gzip 和编码干扰的关键设置
后端若返回 Content-Encoding: gzip，mod_proxy_html 默认不处理压缩内容，链接将原样保留。
- 在
<Location>或<VirtualHost>中加入：RequestHeader unset Accept-Encoding - 确保后端对 HTML 响应不启用 gzip（静态资源可保留压缩）
- 若页面含超长内联脚本，调大缓冲区：
ProxyHTMLBufSize 16384（默认 8192 字节）
验证是否生效的典型现象
配置生效后，访问代理地址时：
- 页面能正常加载（说明 ProxyPass 工作正常）
- 所有
<a>、<img>、<script>、<link>标签里的href或src都已变为代理路径（如/lab/css/app.css），不再出现http://10.5.10.200/...或/css/...导致 404 - 浏览器开发者工具 Network 面板中，资源请求地址均为代理域名下的路径
