Alias仅支持本地文件路径映射，无法实现API到微服务网关的透明代理；必须使用mod_proxy+mod_rewrite组合，通过ProxyPass/ProxyPassReverse完成网络转发、响应头修正及Header透传。
Alias 本身不能实现 API 接口到微服务网关的“透明映射”——它只做 URL 到本地文件系统路径的静态映射，不支持网络转发、协议转换或动态路由。想把 /api/v1/users 这类请求“透明地”打到后端网关（如 APISIX、Spring Cloud Gateway 或自建服务），必须用 mod_proxy + mod_rewrite，而非 Alias。
为什么 Alias 不适用于网关代理场景
Alias 的本质是内部路径重写，目标必须是本机可读的物理目录（如 /var/www/swagger-ui）。它：
- 不发起 HTTP 请求，无法连接远程服务
- 不处理响应头重写（如 Location、Set-Cookie），网关返回的跳转会暴露内网地址
- 不支持协议升级（如 HTTP → Dubbo）、Header 透传或流式响应（SSE）
- 配置后地址栏不变，但行为仍是“读文件”，不是“代理请求”
正确做法：用 ProxyPass + RewriteRule 接管 API 路径
要让客户端仍访问 /api/v1/xxx，而实际流量经 Apache 转发至网关（如 http://apisix-gw:9080），需以下组合：
- 启用模块：
mod_proxy、mod_proxy_http、mod_rewrite - 用
RewriteRule捕获带版本的路径，并加[P]标志启用代理 - 必须配
ProxyPassReverse修正响应中的重定向和 Cookie 域名
示例配置：
Apache 2.4.62
下载
Apache 2.4.62 官方 tar.gz 源码包是 Linux 及类 Unix 系统构建 Web 服务器的核心基础。通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
RewriteEngine On # 将 /api/v1/xxx 映射到网关的 /v1/xxx RewriteRule ^/api/v([0-9]+)/(.*)$ http://apisix-gw:9080/v$1/$2 [P] <h1>修正响应头（关键！否则登录跳转会失效）</h1><p>ProxyPassReverse /api/v1/ <a href="https://www.php.cn/link/2fa6382ac32db77831e7ac6159820da3">https://www.php.cn/link/2fa6382ac32db77831e7ac6159820da3</a> ProxyPassReverse /api/v2/ <a href="https://www.php.cn/link/b1e126b47ff7c8388b3fc84370cb5601">https://www.php.cn/link/b1e126b47ff7c8388b3fc84370cb5601</a></p><h1>可选：透传特定 Header（如认证信息）</h1><p>ProxyPreserveHost On RequestHeader set X-Forwarded-Proto "https" env=HTTPS
若坚持用 Alias，只能用于静态网关前端资源
Alias 仍有实用价值，但仅限于网关的配套静态资产，例如：
- 将
/apisix/dashboard映射到本地解压的 APISIX Dashboard 前端目录 - 将
/swagger映射到本地托管的 OpenAPI UI 页面
此时需严格配对 <Directory> 授权：
Alias /swagger /opt/swagger-ui
<Directory "/opt/swagger-ui">
Require all granted
Options FollowSymLinks
</Directory>
进阶建议：与 APISIX 协同分工
Apache 更适合作为边缘层 TLS 终结、基础鉴权和静态资源服务；真正的 API 路由、限流、缓存、Dubbo 代理应交给 APISIX：
- Apache 处理 HTTPS 卸载、IP 白名单、基础 Basic Auth
- Apache 将
/api/全量代理给 APISIX（ProxyPass /api/ http://apisix-gw:9080/） - APISIX 内部按 Service、Route、Plugin 精细控制每个接口行为
这样既发挥 Apache 的稳定性和成熟生态，又释放 APISIX 的微服务能力，避免在 Apache 中堆砌复杂规则。
