如何使用 Apache 代理实现服务网关的基础功能-Apache-PHP中文网

apache可通过启用mod_proxy、mod_proxy_http等模块，配置proxypass/proxypassreverse实现反向代理，结合proxypreservehost、x-forwarded头透传及超时等加固项，构建具备统一入口、协议转发、请求透传和后端隔离能力的基础服务网关。

如何使用 apache 代理实现服务网关的基础功能

Apache 本身不是专用网关软件，但通过 mod_proxy 及其配套模块，完全可以承担服务网关的基础职责：统一入口、协议转发、请求透传、后端隔离。关键不在“高大上”，而在配置准确、上下文不丢失。

启用必需模块并验证

只开 proxy 和 proxy_http 就能跑通 HTTP 反向代理；若需 HTTPS 后端或负载均衡，再补全对应模块：

proxy_module（主代理引擎，必启）
proxy_http_module（支持 HTTP/HTTPS 后端通信，必启）
proxy_balancer_module + lbmethod_byrequests（多节点轮询，按需）
headers_module（注入 X-Forwarded-* 头，推荐启用）
ssl_module（如需 TLS 终止或代理 HTTPS 后端）

Debian/Ubuntu 系统执行：
sudo a2enmod proxy proxy_http headers
然后检查是否加载成功：
apache2ctl -M | grep proxy
看到 proxy_module (shared) 和 proxy_http_module (shared) 即表示就绪。

配置反向代理虚拟主机

所有代理规则应写在 <virtualhost></virtualhost> 内，避免全局污染。典型配置如下：

<virtualhost>
    ServerName api.example.com
<pre class="brush:php;toolbar:false;">ProxyPreserveHost On
ProxyRequests Off

ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/

# 透传客户端真实 IP 和协议
RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}e" early
RequestHeader set X-Forwarded-Proto "http" early

注意三点：

Apache 2.4.62

PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。

下载

ProxyPass 和 ProxyPassReverse 的路径末尾斜杠必须严格一致，否则 /api/v1 可能被拼成 /api/v1/127.0.0.1:8080
ProxyPreserveHost On 是后端生成正确跳转链接（如登录重定向）的前提
RequestHeader ... early 确保头在请求进入 Apache 处理链早期就被注入，避免被覆盖

让后端真正识别用户请求

默认情况下，后端收到的 request.getRemoteAddr() 是 127.0.0.1，IP 白名单、限流、日志统计全部失效。需前后端配合：

Apache 主动设置：X-Forwarded-For（真实客户端 IP）、X-Forwarded-Proto（HTTP/HTTPS）
后端显式读取这些头：Spring Boot 需设 server.forward-headers-strategy=framework；Tomcat 需在 server.xml 的 <connector></connector> 中添加 remoteIpHeader="x-forwarded-for" 和 protocolHeader="x-forwarded-proto"

不配这一步，网关就只是个“透明管道”，无法支撑鉴权、审计、风控等基础网关能力。