目录：

• IIS6配置方案
• II7配置方案
• Apache配置方案
• Nginx配置方案
• Tomcat配置方案

在大部分实际业务场景中，网站访问请求并不是简单地从用户（访问者）的浏览器直达网站的源站服务器，中间可能经过所部署的CDN、高防IP、WAF等代理服务器。例如，网站可能采用这样的部署架构：用户 > CDN/高防IP/WAF > 源站服务器。这种情况下，访问请求在经过多层加速或代理转发后，源站服务器该如何获取发起请求的真实客户端IP？

一般情况下，透明的代理服务器在将用户的访问请求转发到下一环节的服务器时，会在HTTP的请求头中添加一条X-Forwarded-For记录，用于记录用户的真实IP，其记录格式为X-Forwarded-For:用户IP。如果期间经历多个代理服务器，则X-Forwarded-For将以该格式记录用户真实IP和所经过的代理服务器IP：X-Forwarded-For:用户IP, 代理服务器1-IP, 代理服务器2-IP, 代理服务器3-IP, ……。

因此，常见的Web应用服务器可以 使用X-Forwarded-For的方式获取访问者真实IP。以下分别针对Nginx、IIS 6、IIS 7、Apache和Tomcat服务器，介绍相应的X-Forwarded-For配置方案。

注意 在开始配置前，务必对现有环境进行备份，包括ECS快照备份和Web应用服务器配置文件备份。

一、IIS 6配置方案

通过安装F5XForwardedFor.dll插件，从IIS 6服务器记录的访问日志中获取访问者真实IP地址。

1. 根据服务器的操作系统版本将x86Release或者x64Release目录中的F5XForwardedFor.dll文件拷贝至指定目录（例如，C:ISAPIFilters），同时确保IIS进程对该目录有读取权限。
2. 打开IIS管理器，找到当前开启的网站，在该网站上右键选择属性，打开属性页。
3. 在属性页切换至ISAPI筛选器，单击添加。
4. 在添加窗口下，配置以下参数，并单击确定。筛选器名称：F5XForwardedFor可执行文件：F5XForwardedFor.dll的完整路径，例如C:ISAPIFiltersF5XForwardedFor.dll
5. 重启 IIS 服务器，等待配置生效。

二、IIS 7配置方案

通过安装F5XForwardedFor模块，获取访问者真实IP地址。

1、根据服务器的操作系统版本将x86Release或者x64Release目录中的F5XFFHttpModule.dll和F5XFFHttpModule.ini文件拷贝到指定目录（例如，C:x_forwarded_forx86或C:x_forwarded_forx64），并确保IIS进程对该目录有读取权限。

2、在IIS服务器选项中，双击打开模块。

3、单击配置本机模块。

4、在配置本机模块对话框中，单击注册，分别注册已下载的DLL文件。

注册模块 x_forwarded_for_x86
名称：x_forwarded_for_x86
路径：C:x_forwarded_forx86F5XFFHttpModule.dll
注册模块 x_forwarded_for_x64
名称：x_forwarded_for_x64
路径：C:x_forwarded_forx64F5XFFHttpModule.dll 

5、注册完成后，勾选新注册的模块（x_forwarded_for_x86 和 x_forwarded_for_x64）并单击确定。

6、在API 和CGI限制中，分别添加已注册的DLL，并将其限制改为允许。

7、重启IIS服务器，等待配置生效。

三、Apache配置方案

1、Windows操作系统

在Apache 2.4及以上版本的安装包中已自带remoteip_module模块文件（mod_remoteip.so），您可以通过该模块获取访问者真实IP地址。

1. 在Apache的extra配置文件夹（conf/extra/）中，新建httpd-remoteip.conf配置文件。
   说明 为减少直接修改httpd.conf配置文件的次数，避免因操作失误而导致的业务异常，通过引入remoteip.conf配置文件的方式加载相关配置。
2. 在httpd-remoteip.conf配置文件中，添加以下访问者真实IP的获取规则。

＃加载mod_remoteip.so模块
LoadModule remoteip_module modules/mod_remoteip.so
＃设置RemoteIPHeader头部
RemoteIPHeader X-Forwarded-For
＃设置回源IP段
RemoteIPInternalProxy 112.124.159.0/24 118.178.15.0/24 120.27.173.0/24

1. 修改conf/httpd.conf配置文件，插入httpd-remoteip.conf配置文件。

Include conf/extra/httpd-remoteip.conf

1. 在httpd.conf配置文件中，修改日志格式。

LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%a %l %u %t \"%r\" %>s %b" common

1. 重启Apache服务，使配置生效。

2、Linux操作系统

通过安装Apache的mod_rpaf第三方模块，获取访问者真实IP地址。

1. 执行以下命令，安装mod_rpaf模块。

wget http://stderr.net/apache/rpaf/download/mod_rpaf-0.6.tar.gz
tar zxvf mod_rpaf-0.6.tar.gz
cd mod_rpaf-0.6
/alidata/server/httpd/bin/apxs -i -c -n mod_rpaf-2.0.so mod_rpaf-2.0.c

1. 修改Apache配置文件/alidata/server/httpd/conf/httpd.conf，在文件最后添加以下内容：
   说明 其中， RPAFproxy_ips ip地址不是负载均衡提供的公网IP。具体IP可参考Apache的日志，通常会有两个IP地址。

LoadModule rpaf_module modules/mod_rpaf-2.0.so
RPAFenable On
RPAFsethostname On
RPAFproxy_ips ip地址
RPAFheader X-Forwarded-For

1. 添加完成后，重启Apache服务，使配置生效。
   mod_rpaf模块配置示例

LoadModule rpaf_module modules/mod_rpaf-2.0.so
RPAFenable On
RPAFsethostname On
RPAFproxy_ips 10.242.230.65 10.242.230.131
RPAFheader X-Forwarded-For

四、Nginx配置方案

1. 确认已安装http_realip_module模块
   为实现负载均衡，Nginx使用http_realip_module模块来获取真实IP。

您可以通过执行 # nginx -V | grep http_realip_module命令查看是否已安装该模块。如未安装，则需要重新编译Nginx服务并加装该模块。
说明 一般情况下，如果通过一键安装包安装Nginx服务器，默认不安装该模块。
参考以下方法，安装 http_realip_module模块：

wget http://nginx.org/download/nginx-1.12.2.tar.gz
tar zxvf nginx-1.12.2.tar.gz
cd nginx-1.12.2
./configure --user=www --group=www --prefix=/alidata/server/nginx --with-http_stub_status_module --without-http-cache --with-http_ssl_module --with-http_realip_module
make
make install
kill -USR2 `cat /alidata/server/nginx/logs/nginx.pid`
kill -QUIT `cat /alidata/server/nginx/logs/ nginx.pid.oldbin`

1. 修改Nginx对应server的配置
   打开default.conf配置文件，在 location / {}中添加以下内容：

说明
其中，ip_range1，2，...，x 指WAF的回源IP地址，需要分多条分别添加。

set_real_ip_from ip_range1;
set_real_ip_from ip_range2;
...
set_real_ip_from ip_rangex;
real_ip_header    X-Forwarded-For;

1. 修改日志记录格式 log_format
   log_format一般在nginx.conf配置文件中的http配置部分。在 log_format中，添加 x-forwarded-for字段，替换原来 remote-address字段，即将 log_format修改为以下内容：

log_format  main  '$http_x_forwarded_for - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" ';

完成以上操作后，重启Nginx服务。配置生效后，Nignx服务器即可通过X-Forwarded-For的方式记录访问者真实IP。

五、Tomcat配置方案

通过启用Tomcat的X-Forwarded-For功能，获取访问者真实IP地址。

打开 tomcat/conf/server.xml配置文件，将AccessLogValve日志记录功能部分修改为以下内容：

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%{X-FORWARDED-FOR}i %l %u %t %r %s %b %D %q %{User-Agent}i %T" resolveHosts="false"/>