Nginx 教程- 获取真实IP模块 - http_realip_module_realip模块怎么下载-优快云博客

本文链接：https://blog.youkuaiyun.com/babydavic/article/details/8551626

本文介绍了在Nginx中使用http_realip_module模块来获取用户真实IP的方法，该模块通常用于Nginx在代理服务器后方工作时，通过读取请求头中的X-Real-IP来纠正记录的日志和应用中显示的IP地址。配置包括重新编译Nginx启用该模块，并在location块中设置real_ip_header和set_real_ip_from参数。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

有这么一情况，某网站静态文件很多，而且用户访问的来源有网通，有电信，有铁通...设置还有国外。

为了令处于不同网络运营商的用户收取静态文件的速度都有良好的体现，该网站分别在这些不同运营商的积分中部署了Squid，然后统一 Proxy 到主站的 Nginx 上，形成分布式缓存架构。

如果单是这样的话，主站上 Nginx 的日志，或者应用所获得的IP来源，始终都只会是各个机房中 Squid 的IP。而不是用户的真实IP。Apache 的话，能通过以上所提到的mod_rpaf解决。当然，强大的 Nginx 也有自己的看家法宝。

Nginx 有个在编译时默认不加载的模块 http_realip_module ，就是用来实现这一功能。
但网上很多作者对这一模块的理解完全错误，以为是 Proxy 参数里头的 proxy_set_header 。

proxy_set_header 用于向后端转发 IP head，这一参数是位于 proxy_module 模块中的，而并非 http_realip_module .
好多的博主写文章的时候，都把这模块的用途写成了“为后端应用提供 realip ”

Nginx 官方 wiki 对于该模块的说明 http://wiki.nginx.org/NginxHttpRealIpModule

“It is useful if nginx works behind some proxy of L7 load balanver, and request come from local IP, but proxy add request header with client's IP.

This module isn't built by default, enable it with the configure option ”

说简单了，就是 Nginx 的 http_realip_module = Apache 的 mod_rpaf 用于接受前端发来的 IP head 信息，从获取到真是的用户IP。

配置方式相当简单，重新编译 Nginx 加上 --with-http_realip_module 参数，如：

./configure --prefix=/opt/nginx --with-http_stub_status_module --with-pcre=../pcre-6.6 --with-http_realip_module
make
make install

怎么？Nginx 的服务正在跑着？要重启不容易？
简单，原来你的 Nginx 装在哪，重新编译的时候就选哪，直接 make install 进去就会把原来的覆盖掉。

然后执行 Killall -s USR2 nginx 即可平滑升级。
编辑 Nginx.conf

在 location 里头插入

set_real_ip_from   192.168.1.0/24;     指定接收来自哪个前端发送的 IP head 可以是单个IP或者IP段
set_real_ip_from   192.168.2.1;
real_ip_header     X-Real-IP;         IP head 的对应参数，默认即可。

配置跟 mod_rpaf 大致相同！

配置完成后 sbin/nginx -t 测试语法
测试无误执行 Killall -s HUP nginx 平滑加载配置。

这么就无间断完成了Nginx这一模块的加载。