nginx配置proxy_pass后返回404问题以及Nginx host相关变量的说明

 更新时间:2024年01月25日 15:37:32   作者:eaglecolin  
这篇文章主要介绍了nginx配置proxy_pass后返回404问题以及Nginx host相关变量的说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

预备知识

这里我们先了解Nginx中host相关的变量($host/$http_host/$proxy_host) ,有助于我们理解和解决 proxy_pass 404问题。

  • $host request 请求过来的host,不管是域名还是IP,不管是否为80/443端口,值都为域名或者IP,不带端口
  • $http_host request 请求过来的host,不管是域名还是IP,如果是非80/443端口,值都为域名或者IP加带端口,如果是非80/443端口,值都为域名或者IP
  • $proxy_host 内部进行proxy配置转发的时候默认配置的Host为 $proxy_host, 值为配置的 proxy_pass的值的 域名或者IP部分

比如:

location /demo/ {
    proxy_pass http://ops.colinspace.com/;
}

则 proxy_host为 ops.colinspace.com;

如果配置如下:

location /demo/ {
    proxy_pass http://192.168.3.108:8090/;
}

则 proxy_host为 192.168.3.108:8090;

然后我们再说 proxy_pass抓发的时候默认的Host为 $proxy_host

在nginx官网有个解释:

By default, NGINX redefines two header fields in proxied requests, “Host” and “Connection”, and eliminates the header fields whose values are empty strings.

“Host” is set to the $proxy_host variable, and “Connection” is set to close.

来源参考: https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/

问题分析和修正

其实通过上面的预备知识,现在我们很容易猜到问题所在。

对,问题的点就在于 proxy_pass 转发的时候 Host 变量的值不对

对问题进行问题

1、我们可以在access_log 的输出中打印分别打印出来这三个变量的值,然后进行请求观察分析日志,

2、对比分析不同的域名下关于 proxy相关的配置,发现出问题的域名相比没有问题的域名引用了一个 proxy.conf 的公共配置,这个里面默认设置了

proxy_set_header Host $host

但是proxy转发的时候这个值应该为 $proxy_host 才对, 所以要么取消 对 proxy.conf 公共引用(不建议,因为历史添加肯定有原因);

要么采用如下方案在对应的location中进行添加

location /demo/ {
    proxy_set_host Host $proxy_host;
    # 或者也可以直接指定为转发的域名
    # proxy_set_host Host 'ops.colinspace.com'; 
    proxy_pass http://ops.colinspace.com/;
} 

然后reload,再次请求验证,404 问题修正

问题扩展

  • 为什么请求的时候Header中需要带一个Host配置项呢?
  • 你有没有注意到浏览器请求的时候,Header中默认会自动帮忙我们添加这样的Host配置项呢,或者有时候我们使用curl进行接口验证的时候也需要指定Host才可以

总结

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

相关文章

  • Nginx报错"Too many open files"问题的深度解析与解决方案

    Nginx报错"Too many open files"问题的深度解析

    在高并发场景下,Nginx作为Web服务器或反向代理时,常常会遇到“Too many open files”错误,本文将从问题原理,解决方案,配置优化及验证方法等方面,详细解析如何解决这一问题,希望对大家有所帮助
    2025-06-06
  • 502 Bad Gateway产生的原因及8个详细的解决方法总结

    502 Bad Gateway产生的原因及8个详细的解决方法总结

    Nginx 502 Bad Gateway的错误已经遇到好几次了,这里做一下记录,备忘,下面这篇文章主要给大家介绍了关于502 Bad Gateway产生的原因及8个详细的解决方法,文中的介绍非常详细,需要的朋友可以参考下
    2023-05-05
  • linux(centos5.5)/windows下nginx开启phpinfo模式功能的配置方法分享

    linux(centos5.5)/windows下nginx开启phpinfo模式功能的配置方法分享

    某站点用到结合phpinfo功能的urlrewrite,在nginx中需要在nginx.conf文件中进行配置才可支持phpinfo
    2013-02-02
  • 修改nginx站点根目录总结经验(小结)

    修改nginx站点根目录总结经验(小结)

    这篇文章主要介绍了修改nginx站点根目录总结经验(小结),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-06-06
  • nginx中keepalive配置详解

    nginx中keepalive配置详解

    keepalive是长连接的意思,本文主要介绍了nginx中keepalive配置详解,具有一定的参考价值,感兴趣的可以了解一下
    2023-08-08
  • Nginx服务器https配置的方法示例

    Nginx服务器https配置的方法示例

    这篇文章主要介绍了Nginx服务器https配置的方法示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-10-10
  • 使用nginx正向代理实现访问外网

    使用nginx正向代理实现访问外网

    这篇文章主要介绍了使用nginx正向代理实现让内网主机通过外网主机访问外网,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-12-12
  • Nginx配置SSL证书监听443端口

    Nginx配置SSL证书监听443端口

    这篇文章主要为大家详细介绍了Nginx配置SSL证书监听443端口的方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-02-02
  • nginx+tomcat实现多级反向代理的示例代码

    nginx+tomcat实现多级反向代理的示例代码

    本文介绍在CentOS系统下安装Tomcat、配置虚拟主机多级目录,并通过Nginx反向代理将请求转发至指定IP,构建多级代理拓扑实现负载均衡与访问控制,感兴趣的可以了解一下
    2025-07-07
  • 图文详解Nginx版本平滑升级方案

    图文详解Nginx版本平滑升级方案

    Nginx平滑升级就是指在不停止业务的前提下,实现对Nginx软件版本的升级,下面这篇文章主要给大家介绍了关于Nginx版本平滑升级方案的相关资料,需要的朋友可以参考下
    2021-09-09

最新评论