查询 proxy_redirect 场景 - 豆包

proxy_redirect 是 Nginx 反向代理中用于修正后端服务器返回的 Location 头和 Refresh 头的关键指令，其核心使用场景是解决 “后端返回的跳转地址与前端用户实际访问地址不匹配” 的问题。

当 Nginx 作为反向代理时，后端服务器（如 Tomcat、Node.js 等）可能会返回包含自身内部地址（如 http://backend:8080/path）的跳转指令（Location 头用于 301/302 重定向，Refresh 头用于定时跳转）。但用户实际访问的是 Nginx 代理地址（如 https://example.com/proxy/path），若直接将后端的内部地址返回给用户，会导致跳转失败（用户无法直接访问后端服务器）。

proxy_redirect 的作用就是将后端返回的内部跳转地址替换为用户可访问的代理地址，确保跳转逻辑正确。

以下是几个典型场景和配置示例，帮助理解其实际应用。

场景：

用户访问 Nginx 的路径为 /app/（如 https://example.com/app/）。
Nginx 通过 proxy_pass 将请求转发到后端服务器 http://backend:8080/service/。
后端处理后返回重定向，Location 头为 http://backend:8080/service/login（内部地址）。
若不处理，用户会被跳转到不可访问的 http://backend:8080/service/login，需替换为 https://example.com/app/login。

配置：

server {
    listen 443 ssl;
    server_name example.com;

    location /app/ {
        # 转发请求到后端的 /service/ 路径
        proxy_pass http://backend:8080/service/;
        # 将后端返回的 "http://backend:8080/service/" 替换为 "/app/"
        proxy_redirect http://backend:8080/service/ /app/;
    }
}

效果：
后端返回的 Location: http://backend:8080/service/login 会被修改为 Location: /app/login，用户最终跳转到 https://example.com/app/login（正确的代理路径）。

场景：
当 location 路径与 proxy_pass 目标路径的对应关系清晰时（如案例 1 中 /app/ 对应 /service/），可使用 proxy_redirect default 自动生成替换规则，无需手动指定源地址。

配置：

location /app/ {
    proxy_pass http://backend:8080/service/;
    proxy_redirect default;  # 等效于手动配置 "http://backend:8080/service/ /app/"
}

原理：
default 会自动识别 location 前缀（/app/）和 proxy_pass 中的目标路径（/service/），将后端返回的包含 http://backend:8080/service/ 的跳转地址替换为 /app/，与案例 1 效果一致。

场景：
后端服务器返回的 Location 头包含完整域名和端口（如 http://backend.example.com:8080/path），而用户实际应通过 Nginx 代理的域名 https://example.com 访问。

配置：

location / {
    proxy_pass http://backend.example.com:8080/;
    # 将后端的绝对地址替换为代理的域名（使用变量 $scheme 自动识别 http/https）
    proxy_redirect http://backend.example.com:8080/ $scheme://example.com/;
}

效果：
后端返回的 Location: http://backend.example.com:8080/user 会被修改为 Location: https://example.com/user，用户跳转至正确的代理地址。

场景：
某些特殊场景下（如后端已直接返回正确的代理地址），无需 Nginx 修改 Location 头，可禁用 proxy_redirect。

配置：

location /api/ {
    proxy_pass http://backend:9000/;
    proxy_redirect off;  # 不修改后端返回的任何 Location/Refresh 头
}

注意：仅当确认后端返回的跳转地址对用户可见时使用，否则可能导致跳转失败。

场景：
后端返回的跳转路径包含动态参数（如 http://backend:8080/v1/user?id=123），需替换为代理路径 https://example.com/api/v1/user?id=123。

配置：

location /api/ {
    proxy_pass http://backend:8080/;  # 注意 proxy_pass 末尾无路径，直接转发 /api/xxx 到后端 /xxx
    # 将后端的 "http://backend:8080/" 替换为 "/api/"
    proxy_redirect http://backend:8080/ /api/;
}

效果：
后端返回的 Location: http://backend:8080/v1/user?id=123 会被修改为 Location: /api/v1/user?id=123，即用户访问的 https://example.com/api/v1/user?id=123。

proxy_redirect 的核心价值是在反向代理场景中修正后端跳转地址，确保用户始终通过 Nginx 代理的地址访问，避免暴露后端服务器信息或导致跳转失败。实际配置时需根据后端返回的 Location 格式（路径前缀、绝对地址等）选择手动指定替换规则、使用 default 简化配置，或禁用替换（off）。