alias 仅支持静态路径映射到本地文件系统，不支持代理到上游服务器；正确方案是使用 proxypass 配合 mod_proxy 实现反向代理，并注意 proxypassreverse、路径斜杠及请求头配置。

Alias 指令不能用于代理到上游服务器，因为它根本不是为代理设计的——它只做**静态路径映射**，把 URL 前缀直接对应到本地文件系统路径。想把请求转发给另一个服务器（比如 http://backend:8000），必须换用反向代理机制。

为什么 Alias 不支持代理

Alias 是 Apache 的 内容定位指令，运行在内容处理阶段，仅影响“去哪里找文件”。它不发起网络请求，也不修改 HTTP 流量走向。当你写：

Alias /api http://127.0.0.1:8000 —— 这行配置会被 Apache 忽略或报错，因为 Alias 后面只接受本地绝对路径（如 /opt/backend/static），不接受协议+主机的 URL。

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

正确替代方案：用 ProxyPass 实现上游代理

要将 /api 路径的请求转给后端服务，应使用 mod_proxy 系列指令：

• 确保模块已启用：a2enmod proxy proxy_http（Debian/Ubuntu）或检查 httpd.conf 中 LoadModule proxy_module 和 proxy_http_module 已取消注释
• 在虚拟主机或站点配置中添加：

  <proxy>
      Require all granted
  </proxy>
  ProxyPass "/api" "http://127.0.0.1:8000/"
  ProxyPassReverse "/api" "http://127.0.0.1:8000/"

• ProxyPassReverse 关键：重写后端返回的 Location、Redirect 等响应头，避免浏览器跳转到原始后端地址

常见误区与避坑点

别混用 Alias 和代理逻辑：

• 不要试图用 Alias + RewriteRule 模拟代理——不可靠，且无法透传请求体、头部或保持连接
• 如果同时存在 Alias 和 ProxyPass，且路径有重叠（如都配了 /static），ProxyPass 优先级低于 Alias，但实际行为取决于匹配顺序和上下文，极易出错；建议明确分离：静态资源走 Alias，动态接口走 ProxyPass
• 注意路径结尾斜杠一致性：ProxyPass "/api" "http://…/api/" 和 ProxyPass "/api/" "http://…/api/" 行为不同，前者会把 /api/user 映射为 /api/user，后者映射为 /api/user → /api/user（更安全，推荐加尾部斜杠）

补充：需要改写 Host 或加 Header 怎么办

若后端依赖特定 Host 头或需注入认证信息，可在 ProxyPass 后追加选项：

• ProxyPass "/api" "http://127.0.0.1:8000/" disablereuse=off（复用连接）
• RequestHeader set "X-Real-IP" "%{REMOTE_ADDR}s"（配合 mod_headers）
• ProxyPreserveHost On（把原始 Host 头传给后端）