CDN用户IP获取真实IP：Nginx real_ip方法代码示例2026
在互联网应用中，CDN（内容分发网络）的使用极为广泛，它能显著提升网站的访问速度和稳定性。当使用CDN时，服务器接收到的请求IP通常是CDN节点的IP，而非用户的真实IP。这在很多场景下会带来不便，比如进行用户行为分析、IP封禁等操作时，就需要获取用户的真实IP。Nginx作为一款高性能的Web服务器和反向代理服务器，提供了real_ip模块来解决这个问题。下面将详细介绍使用Nginx real_ip模块获取CDN用户真实IP的方法，并给出代码示例。
我们需要了解Nginx real_ip模块的基本原理。该模块允许我们通过配置，让Nginx从特定的HTTP头中提取用户的真实IP地址。当请求经过CDN时，CDN通常会在HTTP头中添加一些额外的信息，其中就包含用户的真实IP。常见的用于传递真实IP的HTTP头有X-Forwarded-For、X-Real-IP等。
接下来，我们要进行Nginx的配置。在Nginx的配置文件中，我们需要进行以下几个步骤的设置。
第一步，开启real_ip模块。在Nginx的主配置文件（通常是nginx.conf）或者特定虚拟主机的配置文件中，添加以下配置：
```
load_module modules/ngx_http_realip_module.so;
```
这行代码的作用是加载real_ip模块，确保Nginx能够使用该模块的功能。
第二步，设置信任的CDN IP地址。由于我们要从CDN传递的HTTP头中获取真实IP，所以需要告诉Nginx哪些IP地址是可信的CDN节点。可以通过以下配置来实现：
```
set_real_ip_from 192.168.1.0/24; # 这里填写CDN节点的IP地址段
```
这里的192.168.1.0/24是一个示例，你需要根据实际情况替换为CDN提供商提供的IP地址段。可以设置多个IP地址段，以支持多个CDN节点。
第三步，指定从哪个HTTP头中获取真实IP。常见的做法是使用X-Forwarded-For头，配置如下：
```
real_ip_header X-Forwarded-For;
```
如果CDN使用的是X-Real-IP头，那么可以将上述配置修改为：
```
real_ip_header X-Real-IP;
```
第四步，配置日志格式，以便在日志中记录真实IP。在Nginx的日志配置部分，添加以下内容：
```
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
```
这里的$remote_addr会根据real_ip模块的配置，显示用户的真实IP地址。
以下是一个完整的Nginx配置示例：
```
http {
load_module modules/ngx_http_realip_module.so;
server {
listen 80;
server_name example.com;
set_real_ip_from 192.168.1.0/24;
real_ip_header X-Forwarded-For;
access_log /var/log/nginx/access.log main;
location / {
root /var/www/html;
index index.html;
}
}
}
```
在上述配置中，我们开启了real_ip模块，设置了信任的CDN IP地址段，指定从X-Forwarded-For头中获取真实IP，并配置了日志格式。
需要注意的是，在使用Nginx real_ip模块时，要确保CDN提供商正确地在HTTP头中添加了用户的真实IP信息。要定期更新信任的CDN IP地址段，以保证安全性。不同的CDN提供商可能使用不同的HTTP头来传递真实IP，需要根据实际情况进行调整。
通过以上的配置和代码示例，我们可以方便地使用Nginx real_ip模块获取CDN用户的真实IP。这对于网站的运营和管理具有重要意义，能够帮助我们更好地了解用户行为，提升网站的安全性和性能。在实际应用中，我们可以根据具体需求对配置进行进一步的优化和调整，以满足不同的业务场景。
