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

 更新时间:2024年06月20日 08:58:02   作者:老友@  

这篇文章主要介绍了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 头信息。

      总结

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

      声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。