--with-http_realip_module选项（后台Nginx服务器记录原始客户端的IP地址 ）

转自：http://blog.itpub.net/27043155/viewspace-734234/

    通过这个模块允许我们改变客户端请求头中客户端IP地址值(例如，X-Real-IP 或 X-Forwarded-For)。

 

    如果Nginx工作在某些7层负载均衡代理后面，这个功能对于Nginx服务器非常有用，由于客户端请求的本地IP(就是客户端的请求地址)在通过7层代理时被添加了客户端IP地址头，因此才使得后端的Nginx能够取得震慑客户端的IP地址值。该模块在默认安装是并没有安装，因此如果要使用该模块，那么在编译安装是需要添加--with-http_realip_module选项。

 

    为什么使用该模块，它的意义在于能够使得后台服务器记录原始客户端的IP地址。

 

配置示例

 

set_real_ip_from   192.168.1.0/24; set_real_ip_from   192.168.2.1; real_ip_header     X-Real-IP;

   

 

指    令

 

   该模块仅提供了两条指令。

 

指令名称：set_real_ip_from

功    能：通过该指令指定信任的地址，将会被替代为精确的IP地址。从0.8.22版本后也可以使用信任的Unix套接字。这里设置的IP就是指前端Nginx 、Varnish或者 Squid 的 IP地址。

语    法： set_real_ip_from [the address|CIDR|"unix:"]

默 认 值: none

使用环境: http, server, location

 

指令名称：real_ip_header

功    能：这个指令用于设置使用哪个头来替换IP地址。如果使用了X-Forwarded-For，那么该模块将会使用X-Forwarded-For头中的最后一个IP地址来替换前端代理的IP地址。

语    法: real_ip_header [X-Real-IP|X-Forwarded-For]

默 认 值: real_ip_header X-Real-IP

使用环境: http, server, location

 

 

使用实例   

 

    在下面的实例中，我们环境是这样的有两台Nginx服务器，一台是前端，另一台是后端，前端的Nginx被用作代理，而后台的Nginx用于提供页面访问，还有一台客户端，IP地址如下：

  

    前端Nginx：192.168.7.10

    后端Nginx：192.168.1.15

    客户端主机：218.239.201.36

 

 

    前端的Nginx配置是这样的：

 

server {   listen       80;   server_name  www.xx.com;   location / {     root   html;     index  index.html index.htm; charset       utf-8;   }   location  /865 {     proxy_pass   http://192.168.3.139:80/;     proxy_set_header  X-Real-IP        $remote_addr;     proxy_set_header  X-Forwarded-For  $proxy_add_x_forwarded_for; proxy_set_header  Host             $host;     proxy_redirect                     off;   }   …… }

   

   后端的Nginx配置如下：

   

server {   listen       80;   server_name  localhost;     location / {     root   /var/www/html;     index  index.html index.htm;   }

 

访问测试

 

    如果我们访问http://www.xx.com/865，没问题，可以是正常访问，访问日志如下：

 

    前端Nginx的日志：

 

218.239.201.36 - - [30/Aug/2011:16:09:56 +0800] "GET /865/ HTTP/1.1" 200 151 "-" "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.12) Gecko/20101026 Firefox/3.6.12 GTB7.1"

   

    后端Nginx的日志：

 

192.168.7.10 - - [30/Aug/2011:16:09:56 +0800] "GET // HTTP/1.0" 200 151 "-" "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.12) Gecko/20101026 Firefox/3.6.12 GTB7.1"

   

    我们看到在后端Nginx的日志中并没有记录原始客户端的IP地址，而是记录了前端Nginx的IP地址。

 

    如果将后台Nginx服务器的配置修改为：

 

server {   listen       80;   server_name  localhost;   set_real_ip_from   192.168.3.0/24;  set_real_ip_from   100.100.0.0/16;   real_ip_header     X-Real-IP;     location / {     root   html;     index  index.html index.htm;   }       …… }

   

然后我们再次进行访问测试：

 

    前端Nginx的日志：

 

218.239.201.36 - - [30/Aug/2011:16:10:28 +0800 "GET /865/ HTTP/1.1" 304 0 "-" "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.12) Gecko/20101026 Firefox/3.6.12 GTB7.1"

   

    后端Nginx的日志：

 

218.239.201.36 - - [30/Aug/2011:16:10:28 +0800] "GET // HTTP/1.0" 304 0 "-" "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.12) Gecko/20101026 Firefox/3.6.12 GTB7.1"

   

    可见，这次后台记录的是客户端的IP地址。