Nginx配置proxy_pass后返回404的问题及解决

项目场景

需求

开发一个平台系统，前端需要调用多个来自不同服务器的接口，为了满足该需求，需要通过Nginx去转发代理不同的接口地址，防止跨域，实现多接口的调用。

在一次生产涉及多次转发的配置中， 需求是下面的图：

问题描述

问题

在配置好了 proxy_pass 之后，请求 https://smartaitest.com/aitools 直接返回 404，没有什么其他的异常。

但是我们直接请求后端 http://ai-ttxt.com/ 是正常响应的。

看日志请求也是转发到了 http://ai-ttxt.com/。但是转发后的请求响应就是404.

在配置nginx接口转发代理的过程中发现两种不同状况

• 当转发的地址为 ip 时可正常访问。
• 当转发的地址为 域名 时报错为404。

问题原因

我们的默认的 Nginx的 proxy_set_header 配置是

proxy_set_header Host $host;

当我们是这个的设置的时候，当第一层 Nginx(Nginx1)代理后，我们请求的域名是 www.djx.com（假设域名） ,从这个请求的 header 获取到的 host 的值是 www.djx.com, 我们通过 配置将 host 的值设置为转发 的Host 值，但是请求的域名 , 也就是 header 里面的是 host 字段 , 请求的域名和 header 里面的 Host 的不一致导致的。

总结一下 出现两种情况的原因：

• 当转发的地址为 ip 时可正常访问。 
• 当转发的地址为 域名 时报错为404。

1.当使用 proxy_pass 将请求转发到 IP 地址时，Nginx 会将请求的 Host 头信息保持不变地传递给后端服务器。

2.但是当 proxy_pass 设置为域名时，默认情况下，Nginx 会将请求的 Host 头信息设置为当前请求的域名。

这就意味着，如果你使用 proxy_pass 设置为域名时，Nginx 会将请求的 Host头信息设置为当前请求的域名，而不是你指定的域名。这可能会导致后端服务器无法正确识别请求的来源，从而返回 404 错误。

最终造成代理转发访问404的问题出现

解决方案

修改Nginx的 proxy_set_header 配置

proxy_set_header Host $proxy_host;

修改前的nginx.conf 配置

server {
        listen 99;
        server_name _;

        client_max_body_size 100m;

        access_log /var/log/nginx/access-front.log main;
        error_log /var/log/nginx/error-front.log notice;

         location /aitools {
                alias /opt/html/dist;
                index index.html index.htm;

                try_files $uri $uri/ /aitools/index.html;  #aitools为路由 而不是目录
        }
        location /aitools/vapi/ {
                proxy_pass http://ai-ttxt.com/;  # 替换为实际的后端服务器地址

                proxy_set_header Host $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;
        }
    }

修改后的配置

server {
        listen 99;
        server_name _;

        client_max_body_size 100m;

        access_log /var/log/nginx/access-front.log main;
        error_log /var/log/nginx/error-front.log notice;

         location /aitools {
                alias /opt/html/dist;
                index index.html index.htm;

                try_files $uri $uri/ /aitools/index.html;  #aitools为路由 而不是目录
        }
        location /aitools/vapi/ {
                proxy_pass http://ai-ttxt.com/;  # 替换为实际的后端服务器地址

                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_pass http://ai-ttxt.com/ 的接口地址后最好要将末尾的 /代理进去

proxy_set_header Host $host; 和 proxy_set_header Host $proxy_host; 的区别

proxy_set_header Host $host; 和 proxy_set_header Host $proxy_host; 在 Nginx 配置中用于设置代理请求的 Host 头信息：

• $host 变量： $host 变量表示客户端发送请求时的 Host 头信息，即请求的目标域名。它是 Nginx 内置的变量，表示当前请求的主机名。
• $proxy_host 变量： $proxy_host 变量表示 Nginx 代理请求时使用的目标服务器的主机名或 IP 地址。它是 Nginx 内置的变量，表示当前请求中被代理的服务器的主机名或 IP 地址。

因此，区别主要在于这两个变量表示的含义：

• proxy_set_header Host $host; 将请求的 Host 头信息设置为客户端发送请求时的目标域名。这通常用于将请求的 Host 头信息传递给后端服务器，以确保后端服务器能够正确处理请求。
• proxy_set_header Host $proxy_host; 将请求的 Host 头信息设置为 Nginx 代理请求时使用的目标服务器的主机名或 IP 地址。这通常用于在代理请求时设置一个自定义的 Host 头信息，而不是直接使用客户端发送的 Host 头信息。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。