--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地址。