# 获取客户端真实IP
本章节介绍了不同类型的Web应用服务器（包括Tomcat、Apache、Nginx、IIS 6和IIS 7）如何获取客户端的真实IP，如果有此方面需求，可以参考本文进行配置。
#### 背景信息
网站接入CDN加速后，源站服务器端从IP头部获取的用户访问IP不是客户端的真实IP。当您因为业务需要获取客户端真实IP时，可以通过配置网站服务器获取客户端的真实IP。
代理服务器（CDN、WAF等）在把用户的HTTP、WebSocket、WSS请求转到下一环节的服务器时，会在头部中加入一条"X-Forwarded-For"记录，用来记录用户的真实IP，其形式为"X-Forwarded-For：客户端的真实IP，代理服务器1-IP， 代理服务器2-IP，代理服务器3-IP，......"。
因此，您可以通过获取"X-Forwarded-For"对应的第一个IP来得到客户端的真实IP。
#### Nginx如何在访问日志中获取客户端真实IP
如果您的源站部署了Nginx反向代理，可通过在Nginx反向代理配置Location信息，后端Web服务器即可通过类似函数获取客户的真实IP地址。
1. 根据源站Nginx反向代理的配置，在Nginx反向代理的相应location位置配置如下内容，获取客户IP的信息。
   ```
   Location ^ /<uri> {
       proxy_pass  ....;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   }
   ```
   
2. 后端Web服务器通过类似函数获取客户的真实IP。
   ```
   request.getAttribute("X-Forwarded-For")
   ```
   
 
#### Tomcat如何在访问日志中获取客户端真实IP
如果您的源站部署了Tomcat服务器，可通过启用Tomcat的X-Forwarded-For功能，获取客户端的真实IP地址。
1. 打开"server.xml"文件（"tomcat/conf/server.xml"），AccessLogValve日志记录功能部分内容如下：
   ```
   <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
           <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
                  prefix="localhost_access_log." suffix=".txt"
                  pattern="%h %l %u %t "%r" %s %b"/>
   ```
   
2. 在pattern中增加"%{X-Forwarded-For}i"，修改后的server.xml为：
   ```
   <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
           <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
                  prefix="localhost_access_log." suffix=".txt"
                  pattern="%{X-Forwarded-For}i %h %l %u %t "%r" %s %b" />
   </Host>
   ```
   
3. 查看"localhost_access_log"日志文件，可获取X-Forwarded-For对应的访问者真实IP。
 
#### Apache如何在访问日志中获取客户端真实IP
如果您的源站部署了Apache服务器，可通过运行命令安装Apache的第三方模块mod_rpaf，并修改"http.conf"文件获取客户IP地址。
1. 执行以下命令安装Apache的一个第三方模块mod_rpaf。
   ```
   wget https://github.com/gnif/mod_rpaf/archive/v0.6.0.tar.gz
   tar xvfz mod_rpaf-0.6.tar.gz
   cd mod_rpaf-0.6
   /usr/local/apache/bin/apxs -i -c -n mod_rpaf-2.0.so mod_rpaf-2.0.c
   ```
   
2. 打开"httpd.conf"配置文件，并将文件内容修改为如下内容：
   ```
   LoadModule rpaf_module   modules/mod_rpaf-2.0.so ##加载mod_rpaf模块
   <IfModule mod_rpaf.c>
   RPAFenable On
   RPAFsethostname On
   RPAFproxy_ips 127.0.0.1 <反向代理IPs>
   RPAFheader X-Forwarded-For 
   </IfModule>
   ```
   
3. 定义日志格式。
   ```
   LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" common
   ```
   
4. 启用自定义格式日志。
   ```
   CustomLog "/[apache目录]/logs/$access.log" common
   ```
   
5. 重启Apache，使配置生效。
   ```
   /[apached目录]/httpd/bin/apachectl restart
   ```
   
6. 查看"access.log"日志文件，可获取X-Forwarded-For对应的客户端真实IP。
 
#### IIS 6如何在访问日志中获取客户端真实IP
如果您的源站部署了IIS 6服务器，您可以通过安装"F5XForwardedFor.dll"插件，从IIS 6服务器记录的访问日志中获取客户端真实的IP地址。
1. 下载[F5XForwardedFor](https://community.f5.com/kb/technicalarticles/x-forwarded-for-log-filter-for-windows-servers/284578)模块。
2. 根据您服务器的操作系统版本将"x86\\Release"或者"x64\\Release"目录中的"F5XForwardedFor.dll"文件复制至指定目录（例如，"C:\\ISAPIFilters"），同时确保IIS进程对该目录有读取权限。
3. 打开IIS管理器，找到当前开启的网站，在该网站上右键选择"属性"，打开"属性"页面。
4. 在"属性"页面，切换至"ISAPI筛选器"，单击"添加"，在弹出的窗口中，配置如下信息：
   - "**筛选器名称**"："F5XForwardedFor"；
   
   - "**可执行文件**"："F5XForwardedFor.dll"的完整路径，例如："C:\\ISAPIFilters\\F5XForwardedFor.dll"
    
5. 单击"确定"，重启IIS 6服务器。
6. 查看IIS 6服务器记录的访问日志（默认的日志路径为："C:\\WINDOWS\\system32\\LogFiles\\ "，IIS日志的文件名称以".log"为后缀），可获取**X-Forwarded-For**对应的客户端真实IP。
 
#### IIS 7如何在访问日志中获取客户端真实IP
如果您的源站部署了IIS 7服务器，您可以通过安装"F5XForwardedFor"模块，从IIS 7服务器记录的访问日志中获取客户端真实的IP地址。
1. 下载[F5XForwardedFor](https://community.f5.com/kb/technicalarticles/x-forwarded-for-log-filter-for-windows-servers/284578)模块。
2. 根据服务器的操作系统版本将"x86\\Release"或者"x64\\Release"目录中的"F5XFFHttpModule.dll"和"F5XFFHttpModule.ini"文件复制到指定目录（例如，"C:\\x_forwarded_for\\x86"或"C:\\x_forwarded_for\\x64"），并确保IIS进程对该目录有读取权限。
3. 在IIS服务器的选择项中，双击"模块"，进入"模块"界面。
4. 单击"配置本机模块"，在弹出的对话框中，单击"注册"。 ![](https://support.huaweicloud.com/cdn_faq/zh-cn_image_0000001168270913.png)
   
5. 在弹出的对话框中，按操作系统注册已下载的DLL文件后，单击"确定"。
   - x86操作系统：注册模块"x_forwarded_for_x86"
     - 名称：x_forwarded_for_x86
     
     - 路径："C:\\x_forwarded_for\\x86\\F5XFFHttpModule.dll"
     
     
     ![](https://support.huaweicloud.com/cdn_faq/zh-cn_image_0000001121475694.png)
     
   
   - x64操作系统：注册模块"x_forwarded_for_x64"
     - 名称：x_forwarded_for_x64
     
     - 路径："C:\\x_forwarded_for\\x64\\F5XFFHttpModule.dll"
     
     
     ![](https://support.huaweicloud.com/cdn_faq/zh-cn_image_0000001168275471.png)
     
    
6. 注册完成后，勾选新注册的模块（"x_forwarded_for_x86"或"x_forwarded_for_x64"）并单击"确定"。
7. 在"ISAPI和CGI限制"中，按操作系统添加已注册的DLL文件，并将其"限制"改为"允许"。
   - x86操作系统：
     - ISAPI或CGI路径："C:\\x_forwarded_for\\x86\\F5XFFHttpModule.dll"
     
     - 描述：x86
      
   
   - x64操作系统：
     - ISAPI或CGI路径："C:\\x_forwarded_for\\x64\\F5XFFHttpModule.dll"
     
     - 描述：x64
      
    
8. 重启IIS 7服务器，等待配置生效。
9. 查看IIS 7服务器记录的访问日志（默认的日志路径为："C:\\WINDOWS\\system32\\LogFiles\\ "，IIS日志的文件名称以".log"为后缀），可获取X-Forwarded-For对应的客户端真实IP。