文档首页> 内容分发网络 CDN> 最佳实践> 获取客户端真实IP
更新时间:2022-09-09 GMT+08:00

获取客户端真实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模块。
  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模块。
  2. 根据服务器的操作系统版本将“x86\Release”或者“x64\Release”目录中的“F5XFFHttpModule.dll”和“F5XFFHttpModule.ini”文件拷贝到指定目录(例如,“C:\x_forwarded_for\x86”或“C:\x_forwarded_for\x64”),并确保IIS进程对该目录有读取权限。
  3. 在IIS服务器的选择项中,双击“模块”,进入“模块”界面。
  4. 单击“配置本机模块”,在弹出的对话框中,单击“注册”。

  5. 在弹出的对话框中,按操作系统注册已下载的DLL文件后,单击“确定”。
    • x86操作系统:注册模块“x_forwarded_for_x86”
      • 名称:x_forwarded_for_x86
      • 路径:“C:\x_forwarded_for\x86\F5XFFHttpModule.dll”

    • x64操作系统:注册模块“x_forwarded_for_x64”
      • 名称:x_forwarded_for_x64
      • 路径:“C:\x_forwarded_for\x64\F5XFFHttpModule.dll”

  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。