图解 nginx 如何获取真实的来源 IP

Posted 2023-04-23

参考技术A

$remote_addr ：这是 nginx 中的一个变量，是 理论上 请求来源的 IP 地址
$direct_ip ：这是为例方便理解本文虚构的一个变量名，表示向 nginx 直接发起请求的客户端的真正 IP 地址

$direct_ip 是 无法伪造 的，因为建立 TCP 连接需要三次握手，如果伪造了源 IP，无法建立 TCP 连接，更不会有后面的 HTTP 请求。
一般来说 $remote_addr 就等于 $direct_ip ，我们通常也就是这样直接地判断请求来源。
但是，在多层反向代理的架构中，这个 $direct_ip 往往是一台内部服务器的 IP，不能真实的反应请求的来源，如下图：

为此，在 nginx 中的 $remote_addr 取值专门设计了特定的逻辑
有三个重要变量可在 nginx 中配置：

set_real_ip_from ：默认为空，可设置为任意 IP 或 IP 段，实例中的 0.0.0.0/0 表示覆盖了所有网段
real_ip_header ：默认值是 X-Real-IP，可以设置为任意字符串，一般建议改用 X-Forwarded-For，下面也均以 X-Forwarded-For 为例
real_ip_recursive ：默认为 off，可设 on / off 两种值

网上介绍 $remote_addr 取值逻辑的文章有很多，此文不做赘述。
我们今天就单用一张图来解释下这个流程（点击图片查看大图）：

服务端 nginx 配置：

上一级代理发来请求:

理论上真实来源 IP:
$remote_addr = 2.2.2.2

在多层反向代理的架构中，每一个 nginx 节点最好都添加上如下配置条目：

https://blog.csdn.net/qq_33101675/article/details/79013248 (红字部分解释得好)
https://www.jianshu.com/p/15f3498a7fad

使用Nginx自带的Realip模块获取用户真实IP

（一）简要说明  

  如果你的Web服务器前端有代理服务器或CDN时日志中的$remote_addr可能就不是客户端的真实IP了。比较常用的解决方法有以下三几种，本文将主要介绍如何使用Nginx自带realip模块来解决这一问题

：

1，用CDN自定义IP头来获取

2，通过HTTP_X_FORWARDED_FOR获取IP地址

3，使用Nginx自带模块realip获取用户IP地址

    ngx_realip模块究竟有什么实际用途呢？为什么我们需要去改写请求的来源地址呢？答案是：当Nginx处理的请求经过了某个HTTP代理服务器的转发时，这个模块就变得特别有用。

    当原始用户的请求经过代理（squid,proxy）转发之后，nginx接收到的请求的来源地址也就变成了该代理服务器的IP，于是乎nginx 就无法获取用户请求的真实IP地址了。

   所以，一般我们会在Nginx之前的代理服务器中把请求的原始来源地址编码进某个特殊的HTTP请求头中，然后再在Nginx中把这个请求头中编码的地址恢复出来。这样Nginx中的后续处理阶段(包括Nginx背后的各种后端应用)就会认为这些请求直接来自那些原始的地址，代理服务器就仿佛不存在一样。ngx_realip模块正是用来处理这个需求的。

（二）安装realip模块

[[email protected] nginx-1.9.1]#./configure --prefix=/usr/local/nginx --with-http_stub_status_module  --with-pcre=../pcre-6.6 

--with-http_realip_module

[[email protected] nginx-1.9.1]#make

[[email protected] nginx-1.9.1]#make install

(三）配置语法

set_real_ip_from 192.168.1.0/24; #真实服务器上一级代理的IP地址或者IP段,可以写多行。 set_real_ip_from 192.168.2.1; 

real_ip_header   X-Forwarded-For;  #从哪个header头检索出所要的IP地址。

real_ip_recursive on;      #递归的去除所配置中的可信IP。排除set_real_ip_from里面出现的IP。如果出现了未出现这些IP段的IP，那么这个IP将被认为是用户的IP。

一下就是配置实例：

server {
                listen 80;
                server_name  localhost;
                index index.html index.htm index.php;
                #include deny.ip;
                access_log /data/nginx.access.log;
                  location ~ .* {
                    proxy_pass http://192.168.180.20;
                    proxy_set_header X-Real-IP $remote_addr;
                    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                   #proxy_set_header X-Forward-For $remote_addr;
                    proxy_set_header Host $host;
                    set_real_ip_from  192.168.180.0/24;
                    set_real_ip_from 192.168.181.0/24;
                    real_ip_header    X-Forwarded-For;
                    real_ip_recursive on;
                        }
        }

如果服务器获取的IP地址如下：

192.168.180.4

192.168.181.30

118.242.26.94

在real_ip_recursive on的情况下，192.168.180.4和192.168.181.30这两个IP地址都在set_real_ip_from中出现，仅仅118.242.26.94没有出现，那么这个IP就被认为是用户的IP地址，并且赋值到remote_addr变量。

在real_ip_recursive off或者不设置的情况下,192.168.180.4出现在了set_real_ip_from中会被排除掉，其它的IP地址便认为是用户的ip地址。

具体的可以参考nginx官方文档：http://nginx.org/en/docs/http/ngx_http_realip_module.html

本文出自 “清风明月” 博客，请务必保留此出处http://liqingbiao.blog.51cto.com/3044896/1908461