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

来自:网络
时间:2024-09-10
阅读:

项目场景

需求

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

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

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

问题描述

问题

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

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

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

Nginx配置proxy_pass后返回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 的不一致导致的。

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

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

  • 当转发的地址为 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 头信息。

总结

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

返回顶部
顶部