Nginx 代理重定向配置说明

本篇说明将介绍一个基于Nginx的配置示例，重点解决在代理场景下处理重定向（如301、302）的问题。该配置能够捕获并处理重定向请求，避免可能出现的循环重定向问题，并确保代理请求顺利完成。

配置结构

server {
    listen 80;
    server_name localhost;
    proxy_intercept_errors on;

    location /ssoproxy/ {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-Ip $remote_addr;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://logins/;
        error_page 301 302 = @handle_redirect;
    }

    location / {
        proxy_pass http://backend;
    }

    location @handle_redirect {
        set $redirect_location '$upstream_http_location';
        
        if ($redirect_location = $scheme://$host$request_uri) {
            return 500; # 防止重定向到自己，导致无限循环
        }

        proxy_pass $redirect_location;
        error_page 301 302 = @handle_redirect;
    }
}

配置说明

基础配置
- listen 80;：指定服务器监听80端口，用于处理HTTP请求。
- server_name localhost;：定义服务器名称，这里设置为localhost。
开启错误拦截
- proxy_intercept_errors on;：此指令开启了Nginx的错误拦截功能，使得Nginx能够捕获和处理后端服务器返回的错误代码，如301、302重定向。
Location配置
- **location /ssoproxy/**：
  - 用于处理路径为/ssoproxy/的代理请求。
  - 配置了多个proxy_set_header指令，用于传递客户端请求头信息，例如Host、X-Real-Ip、REMOTE-HOST和X-Forwarded-For，确保代理请求能够正确地携带客户端的相关信息。
  - proxy_pass http://logins/;：将请求转发到后端服务器logins。
  - error_page 301 302 = @handle_redirect;：当后端返回301或302重定向时，Nginx会将请求转发到@handle_redirect位置进行进一步处理。
- **location /**：
  - 用于处理根路径/的所有其他请求。
  - 直接将请求转发到后端服务器backend，不涉及重定向处理。
处理重定向
- **location @handle_redirect**：
  - 当重定向发生时，Nginx会进入这个块中进行处理。
  - set $redirect_location '$upstream_http_location';：通过$upstream_http_location变量获取后端服务器返回的Location头信息，并将其存储在$redirect_location变量中。
  - if ($redirect_location = $scheme://$host$request_uri) { return 500; }：防止重定向到自身，避免出现无限循环的情况。如果重定向地址等于当前请求的URL，Nginx将返回500错误。
  - proxy_pass $redirect_location;：将请求代理到捕获到的重定向地址。
  - error_page 301 302 = @handle_redirect;：如果新的请求再次返回301或302重定向，继续进入此处理块进行递归处理。

配置特点

防止无限重定向：通过条件判断避免重定向回到自身，从而有效防止可能出现的无限循环问题。
灵活的重定向处理：捕获并处理后端返回的301、302重定向，使Nginx能够根据重定向地址动态代理请求。
完整的请求头转发：保留并传递了客户端的请求头信息，确保后端能够接收到完整的客户端信息，以便做进一步处理。

使用场景

该配置特别适用于需要在代理场景下处理重定向的系统。例如，在处理单点登录（SSO）系统的重定向请求时，可以通过该配置确保Nginx正确地捕获重定向地址并完成代理，避免不必要的请求循环或错误。

通过合理配置Nginx的代理和错误处理机制，可以有效提升系统的稳定性和可靠性，确保各类请求能够顺畅地完成。