ProxyPass和ProxyPassReverse必须成对使用且路径（含末尾斜杠）严格一致，否则导致后端接收错误路径、重定向失效、Cookie丢失或代理中断；需启用mod_proxy和mod_proxy_http模块，并置于VirtualHost块内配置。

proxypass 和 proxypassreverse 必须成对使用，且路径写法必须严格一致，否则后端服务会收到错误路径、重定向失效、cookie 丢失，甚至整个代理链路中断。

模块启用是前提

两个指令依赖 mod_proxy 和 mod_proxy_http 模块。缺一不可，否则 Apache 启动失败或返回 500 错误。

• 编辑主配置文件（如 /etc/apache2/apache2.conf 或 /etc/httpd/conf/httpd.conf）
• 确保以下两行未被注释：
  LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
• 执行 apache2ctl -M | grep proxy（Debian/Ubuntu）或 httpd -M | grep proxy（RHEL/CentOS），确认输出中包含 proxy_module (shared) 和 proxy_http_module (shared)
• 重启服务：sudo systemctl restart apache2 或 sudo systemctl restart httpd

路径斜杠必须前后统一

这是最容易出错的点。ProxyPass 和 ProxyPassReverse 的路径末尾斜杠决定“前缀是否被截断”，也影响后端收到的 URI 结构。

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

• ProxyPass /api/ http://127.0.0.1:3000/ → 客户端请求 /api/users，后端收到 /users
• ProxyPass /api http://127.0.0.1:3000/（少斜杠）→ 同样请求变成 /apiusers，大概率 404
• ProxyPassReverse 的路径必须与 ProxyPass 完全一致，包括开头和结尾的斜杠，否则 Location 头改写失败

必须放在 VirtualHost 块内

全局配置中直接写 ProxyPass 会导致规则污染、域名冲突、日志混乱，Apache 官方也明确建议只在 <VirtualHost> 中定义。

• 例如绑定域名 api.example.com 到本地 Node.js 服务：
  

  <VirtualHost *:80><br>
    ServerName api.example.com<br>
    ProxyPreserveHost On<br>
    ProxyPass / http://127.0.0.1:3000/<br>
    ProxyPassReverse / http://127.0.0.1:3000/<br>
  </VirtualHost>

• ProxyPreserveHost On 让后端能读取原始 Host 头，对多租户或基于域名的路由很关键

它们各自解决什么问题

ProxyPass 负责“把进来的请求转给谁”，是单向转发；ProxyPassReverse 负责“把后端返回的重定向、Cookie 等响应头修正回来”，是反向修复。

• 后端返回 302 并带 Location: http://127.0.0.1:3000/login → 浏览器直连内网地址，失败
• 有 ProxyPassReverse / http://127.0.0.1:3000/ → Apache 自动改写为 Location: https://api.example.com/login
• 同样，Set-Cookie 中的 Domain=127.0.0.1 或 Path=/app/ 也会被相应修正