CDN用户IP获取真实IP：Nginx real_ip 2026配置使用代码示例
在互联网应用中，CDN（内容分发网络）的使用极为广泛，它能显著提升网站的访问速度和性能。当网站使用CDN时，服务器接收到的请求IP地址通常是CDN节点的IP，而非用户的真实IP地址。这就会给诸如用户行为分析、安全防护等需要准确获取用户真实IP的场景带来困扰。为了解决这一问题，Nginx提供了real_ip模块，通过合理配置该模块，我们可以从请求中提取出用户的真实IP地址。下面我们将详细介绍如何使用Nginx real_ip模块进行配置以获取CDN用户的真实IP，并给出相应的代码示例。
Nginx real_ip模块是一个强大的工具，它允许我们指定哪些IP地址是可信的代理服务器，然后从请求头中提取出客户端的真实IP地址。在使用CDN的场景下，CDN节点就是这些可信的代理服务器。要使用real_ip模块，首先需要确保Nginx已经安装并启用了该模块。一般来说，大多数主流的Nginx安装包都默认包含了该模块。
接下来，我们需要配置Nginx以识别CDN节点的IP地址。在Nginx的配置文件中，我们可以使用`set_real_ip_from`指令来指定可信的IP地址或IP段。例如，如果我们使用的是阿里云CDN，可以从阿里云的官方文档中获取其CDN节点的IP段列表，然后将这些IP段添加到`set_real_ip_from`指令中。以下是一个示例：
```nginx
set_real_ip_from 1.1.1.0/24;
set_real_ip_from 2.2.2.0/24;
# 可以根据实际情况添加更多的IP段
```
在指定了可信的IP地址后，我们还需要告诉Nginx从哪个请求头中获取真实IP地址。通常，CDN会将用户的真实IP地址放在`X-Forwarded-For`请求头中。我们可以使用`real_ip_header`指令来指定这个请求头，示例如下：
```nginx
real_ip_header X-Forwarded-For;
```
为了确保安全性，我们还可以使用`real_ip_recursive`指令来控制是否递归解析`X-Forwarded-For`头中的IP地址。默认情况下，该指令的值为`off`，表示只取`X-Forwarded-For`头中的第一个IP地址。如果设置为`on`，则会递归解析该头中的所有IP地址，直到找到一个不在可信IP列表中的IP地址。以下是一个完整的Nginx配置示例：
```nginx
server {
listen 80;
server_name example.com;
# 设置可信的IP地址
set_real_ip_from 1.1.1.0/24;
set_real_ip_from 2.2.2.0/24;
# 可以根据实际情况添加更多的IP段
# 指定从哪个请求头中获取真实IP
real_ip_header X-Forwarded-For;
# 控制是否递归解析X-Forwarded-For头
real_ip_recursive on;
location / {
# 处理请求的逻辑
return 200 "Your real IP is $remote_addr";
}
}
```
在上述配置中，当客户端通过CDN访问`example.com`时，Nginx会根据`set_real_ip_from`指定的可信IP地址，从`X-Forwarded-For`请求头中提取出用户的真实IP地址，并将其赋值给`$remote_addr`变量。这样，在处理请求时，我们就可以使用`$remote_addr`变量来获取用户的真实IP地址。
需要注意的是，在实际使用中，我们需要定期更新`set_real_ip_from`指令中的IP段列表，以确保Nginx能够正确识别最新的CDN节点IP地址。不同的CDN提供商可能会使用不同的请求头来传递用户的真实IP地址，因此在配置时需要根据实际情况进行调整。
通过合理配置Nginx real_ip模块，我们可以方便地获取CDN用户的真实IP地址，为网站的用户行为分析、安全防护等提供有力支持。在实际应用中，我们需要根据具体的CDN提供商和业务需求，灵活调整配置参数，以确保系统的稳定性和安全性。
