Nginx 1.25.3动态反向代理502错误排查求助

你的配置存在两个核心问题导致502错误，以下是具体修复方案：

问题分析 #

1. Host头传递错误：原配置中proxy_set_header Host $host;传递的是localhost，目标服务器（如example.com）收到Host为localhost的请求时，无法正确识别并返回有效响应。
2. URI自动追加问题：当proxy_pass使用变量时，Nginx会将原请求的完整URI（包括查询参数）追加到目标URL后，导致实际转发的地址是http://example.com/?redirect_url=http://example.com，这不符合你直接转发到目标根路径的需求，部分服务器会因此返回错误。

修复后的配置 #

1. 简化并增强URL匹配的map规则 #

map $arg_redirect_url $dynamic_redirect_url {
    default "";
    # 仅匹配http/https开头的合法URL，避免无效值
    "~^https?://.*$" $arg_redirect_url;
}

2. 修正server块配置 #

server {
    listen 80;
    server_name localhost;
    resolver 8.8.8.8;

    location / {
        # 仅当获取到合法redirect_url时执行代理
        if ($dynamic_redirect_url) {
            # 清空原请求的URI和查询参数，仅转发到目标URL的根路径
            rewrite ^.*$ $dynamic_redirect_url? break;
            
            proxy_pass $dynamic_redirect_url;

            # 传递目标服务器的Host头，替代原localhost
            proxy_set_header Host $proxy_host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";

            # 修正目标服务器的重定向地址，避免跳转错误
            proxy_redirect ~^https?://[^/]+/(.*) /$1;
        }

        # 无有效redirect_url时返回明确提示
        return 400 "Missing valid redirect_url parameter (must start with http/https)";
    }
}

关键修改说明 #

• Host头调整：使用$proxy_host自动获取目标URL的主机（含端口），确保目标服务器能正确识别请求。
• URI清空：通过rewrite ^.*$ $dynamic_redirect_url? break;丢弃原请求的URI和查询参数，仅转发到目标URL的根路径。
• 增强URL校验：map规则仅匹配http/https开头的URL，避免无效参数导致的代理错误。
• 重定向修正：proxy_redirect指令修正目标服务器返回的重定向地址，防止跳转路径错误。

测试时访问http://localhost/?redirect_url=http://example.com，即可正常获取目标页面。

内容的提问来源于stack exchange，提问作者theRenaissance