在云服务器部署PHP应用的过程中，很多开发者会遇到获取客户端IP地址不符合预期的情况，比如获取到的是负载均衡的内网地址、CDN节点的IP，甚至返回空值，这会影响到日志记录、访问限制、用户定位等功能的正常运行。不同云服务架构下的网络转发逻辑存在差异，需要针对性调整IP获取的逻辑。
云服务器IP获取异常的常见原因
云服务器环境通常会在应用服务器前端增加多层网络组件，这是导致IP获取异常的核心原因，常见场景包括：
- 前端部署了负载均衡服务，请求先经过负载均衡再转发到后端PHP服务器，此时PHP获取到的REMOTE_ADDR是负载均衡的IP
- 使用了CDN加速服务，用户请求先到达CDN节点，再由CDN回源到云服务器，默认获取的是CDN节点IP
- 服务器配置了反向代理，比如用Nginx做代理转发，没有正确传递客户端真实IP到后端
- PHP配置中关闭了相关环境变量获取权限，导致无法读取代理传递的自定义头信息
PHP常规获取IP的方法及局限
默认情况下，PHP可以通过超全局变量$_SERVER获取客户端IP，最常用的是REMOTE_ADDR参数，但是这个方法在云服务器环境下存在明显局限。
先看常规的获取代码示例：
<?php
// 常规获取客户端IP的方法
function getClientIpNormal() {
if (!empty($_SERVER['REMOTE_ADDR'])) {
return $_SERVER['REMOTE_ADDR'];
}
return '未知IP';
}
// 调用输出
echo getClientIpNormal();
?>
上面的代码直接读取REMOTE_ADDR，在直连服务器的场景下可以正常获取客户端IP，但是在云服务器有代理转发的场景下，这个值会变成最近一层代理的IP，无法得到真实客户端地址。
云服务环境PHP获取IP的调整方法
针对云服务器的代理场景，需要在获取IP的逻辑中优先读取代理传递的客户端真实IP头，再 fallback 到默认的REMOTE_ADDR，同时要做好校验避免IP伪造。
1. 确认代理传递的自定义头字段
首先要和运维确认前端代理（负载均衡、CDN、Nginx）传递真实IP的自定义头名称，常见的包括：
- X-Forwarded-For：最通用的代理头，记录经过的代理链IP，第一个IP通常是真实客户端IP
- X-Real-IP：部分代理会直接传递真实客户端IP到这个头
- CF-Connecting-IP：Cloudflare CDN使用的真实IP头
2. 调整后的完整获取函数
下面是针对云服务器环境的通用IP获取函数，兼容多种代理场景，同时做了基本的合法性校验：
<?php
/**
* 云服务环境获取真实客户端IP
* @return string 客户端IP地址
*/
function getCloudClientIp() {
// 优先读取常见的代理传递真实IP头
$ipHeaders = [
'HTTP_X_FORWARDED_FOR',
'HTTP_X_REAL_IP',
'HTTP_CF_CONNECTING_IP',
'HTTP_CLIENT_IP'
];
foreach ($ipHeaders as $header) {
if (!empty($_SERVER[$header])) {
$ipStr = $_SERVER[$header];
// X-Forwarded-For可能包含多个IP，取第一个非未知的IP
if ($header == 'HTTP_X_FORWARDED_FOR') {
$ipList = explode(',', $ipStr);
foreach ($ipList as $ip) {
$ip = trim($ip);
// 校验IP合法性，排除内网IP和无效IP
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
return $ip;
}
}
} else {
// 其他头直接取第一个IP
$ip = trim($ipStr);
if (filter_var($ip, FILTER_VALIDATE_IP)) {
return $ip;
}
}
}
}
// 所有代理头都没有的话，取REMOTE_ADDR
if (!empty($_SERVER['REMOTE_ADDR'])) {
return $_SERVER['REMOTE_ADDR'];
}
return '未知IP';
}
// 调用示例
echo getCloudClientIp();
?>
3. Nginx代理配置配合调整
如果云服务器前端用的是Nginx做反向代理，需要在Nginx配置中添加传递真实IP的配置，否则后端PHP无法读取到对应的自定义头：
# Nginx代理配置示例
location / {
proxy_pass http://127.0.0.1:9000; # PHP-FPM地址
# 传递真实客户端IP
proxy_set_header X-Real-IP $remote_addr;
# 传递代理链IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# 传递主机头
proxy_set_header Host $host;
}
IP获取异常排查步骤
如果遇到IP获取异常，可以按照以下步骤逐步排查：
- 先打印
$_SERVER变量的所有内容，查看是否有代理传递的IP相关头，确认头的名称 - 检查前端代理（负载均衡、CDN）的配置，确认是否已经开启真实IP传递功能
- 验证PHP代码中的头名称是否和代理传递的一致，注意
$_SERVER中的头会把中划线转成下划线，并且前缀加HTTP_ - 测试直接访问云服务器IP（不经过CDN和负载均衡），看是否能正常获取IP，定位是否是代理层的问题
- 检查PHP的
variables_order配置，确保包含E、G、P、C、S，否则可能无法读取$_SERVER变量
注意事项
在调整IP获取逻辑时，需要注意以下几点：
- 不要完全信任代理传递的IP头，因为这些头可以被客户端伪造，重要场景需要结合其他校验方式
- 如果业务需要记录完整代理链，可以把X-Forwarded-For的完整值也存储下来，方便后续排查问题
- 部分云服务商的负载均衡需要在控制台单独开启真实IP透传功能，仅配置后端代码是不够的
- 获取到的IP如果需要用于地理位置查询，要注意排除内网IP和保留IP段
PHP云服务器IP获取代理头REMOTE_ADDR修改时间：2026-07-16 02:21:32