如何通过proxy_pass绝对路径擦除Location前缀实战-Nginx-PHP中文网

关键在于proxy_pass结尾斜杠决定路径截断，proxy_redirect显式重写Location头；/api/→/需严格对应，正则可实现动态剥离与安全过滤。

如何通过proxy_pass绝对路径擦除location前缀实战

用 proxy_pass 实现绝对路径重写、擦除响应头中 Location 的前缀，关键在于理解 Nginx 如何处理重写与重定向的协同关系。单纯配置 proxy_pass 不足以自动修正后端返回的 Location 头，必须配合 proxy_redirect 显式重写。

明确 proxy_pass 路径结尾斜杠的作用

Nginx 对 proxy_pass 后 URL 是否带结尾斜杠极为敏感，它直接决定路径替换行为：

proxy_pass http://backend/;（带斜杠）→ 当前 location 匹配的路径前缀被完全擦除，后端收到的是绝对路径（如请求 /api/v1/user，转发为 /v1/user）
proxy_pass http://backend;（不带斜杠）→ 原始 URI 完整拼接，不做路径截断（如请求 /api/v1/user，转发为 /api/v1/user）

Location 响应头不会自动改写，必须用 proxy_redirect

后端返回 302/301 时附带的 Location: /api/v1/login，Nginx 默认原样透传给客户端——这会导致跳转失败。需用 proxy_redirect 将其重写为客户端可访问的路径：

proxy_redirect /api/ /; → 把响应头中所有以 /api/ 开头的 Location 替换为 /
proxy_redirect http://old.com/api/ https://new.com/; → 支持完整 URL 替换，适用于跨域或协议变更场景
若设为 proxy_redirect off;，则完全禁用重写（仅调试时使用）

典型实战配置示例（擦除 /api 前缀）

假设用户访问 https://example.com/api/v1/data，需转发至 http://127.0.0.1:8000/v1/data，且后端可能返回 Location: /api/v1/login，期望重写为 /v1/login：

aperture: the L402 aware reverse proxy

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

下载

location /api/ {
    proxy_pass http://127.0.0.1:8000/;
    proxy_redirect /api/ /;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

注意：proxy_pass 后的 / 和 proxy_redirect 中的 /api/ → / 必须严格对应，否则重写失效。