备案号:蜀ICP备2026035467号-3|www.xservx.com

php 获取ip地址

一、php 获取ip地址的核心逻辑

在 PHP 中,获取客户端 IP 地址看似简单,实则暗藏玄机。初学者常误以为直接使用 $_SERVER['REMOTE_ADDR'] 即可,但这一方式在现代网络架构(如 CDN、反向代理、负载均衡、IPv6 网络)下极易失效或返回内网地址。因此,全面理解 IP 获取机制是构建安全 Web 应用的基石。

IP 的本质与分类
IP(Internet Protocol)地址用于标识网络中的设备。IPv4 使用 32 位地址(如 192.168.1.100),IPv6 使用 128 位地址(如 2001:0db8:85a3::8a2e:0370:7334)。PHP 默认支持 IPv6,但需注意解析方式差异。

客户端 IP ≠ REMOTE_ADDR
当用户通过代理服务器、CDN(如 Cloudflare、阿里云 CDN)、负载均衡(如 Nginx)访问网站时,$_SERVER['REMOTE_ADDR'] 返回的是**最后一跳服务器的 IP**,而非用户真实 IP。例如:

  • 用户 → CDN 节点 → 源站:此时 REMOTE_ADDR = CDN 节点 IP
  • 用户 → Nginx 反向代理 → PHP-FPM:此时 REMOTE_ADDR = Nginx IP(通常为 127.0.0.1)

因此,仅依赖 REMOTE_ADDR 将导致地理位置定位失效、访问日志失真、风控策略误判。

为何需要多层 IP 检测?

现代 Web 架构中,请求路径往往经过多层转发。每层代理可能添加或修改 HTTP 头字段,用于传递原始客户端信息。关键字段包括:

  • HTTP_X_FORWARDED_FOR:最常见代理头,格式为 client, proxy1, proxy2
  • HTTP_X_REAL_IP:Nginx 默认传递的真实客户端 IP
  • HTTP_CLIENT_IP:部分代理使用的字段
  • HTTP_X_CLUSTER_CLIENT_IP:集群环境常用
  • HTTP_CF_CONNECTING_IP:Cloudflare 专用字段

⚠️ 注意:这些字段均可被客户端伪造!因此必须结合信任链判断逻辑。

二、主流获取方法详解与代码示例

1. 标准检测法:多字段轮询 + 信任验证

该方法优先检查代理可信头,再回退至 REMOTE_ADDR,同时排除内网地址(如 10.x.x.x、172.16.x.x–172.31.x.x、192.168.x.x)及无效值(如 0.0.0.0、空字符串)。

<?php
function getClientIP() {
    $ip = '';
    // 按优先级检查代理头
    if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        // 可能含多个 IP,取第一个非内网 IP
        $ips = array_map('trim', explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']));
        foreach ($ips as $ipCandidate) {
            if (filter_var($ipCandidate, FILTER_VALIDATE_IP) && !is_private_ip($ipCandidate)) {
                $ip = $ipCandidate;
                break;
            }
        }
    }
    if (!$ip && !empty($_SERVER['HTTP_X_REAL_IP'])) {
        $ip = $_SERVER['HTTP_X_REAL_IP'];
    }
    if (!$ip && !empty($_SERVER['HTTP_CLIENT_IP'])) {
        $ip = $_SERVER['HTTP_CLIENT_IP'];
    }
    // 回退至原始连接 IP(最可靠但可能非用户真实 IP)
    if (!$ip && !empty($_SERVER['REMOTE_ADDR'])) {
        $ip = $_SERVER['REMOTE_ADDR'];
    }
    return $ip ?: 'unknown';
}
function is_private_ip($ip) {
    $private_ranges = [
        '10.0.0.0/8',
        '172.16.0.0/12',
        '192.168.0.0/16',
        '127.0.0.0/8',
        '0.0.0.0/8',
        '::1/128',        // IPv6 localhost
        'fc00::/7',       // IPv6 unique local addr
        'fe80::/10'       // IPv6 link-local addr
    ];
    foreach ($private_ranges as $range) {
        if (ip_in_range($ip, $range)) {
            return true;
        }
    }
    return false;
}
function ip_in_range($ip, $range) {
    if (strpos($range, '/') !== false) {
        list($subnet, $bits) = explode('/', $range);
        $ip = ip2long($ip);
        $subnet = ip2long($subnet);
        $mask = -1 << (32 - $bits);
        $subnet &= $mask;
        return ($ip & $mask) === $subnet;
    }
    return $ip === $range;
}
?>

关键细节:

  • 使用 filter_var($ip, FILTER_VALIDATE_IP) 验证 IP 格式合法性
  • 优先取 X-Forwarded-For 中第一个非内网 IP(最接近用户的真实地址)
  • 内网 IP 过滤防止代理回环攻击(如伪造 X-Forwarded-For: 127.0.0.1)

2. CDN 适配法:Cloudflare 与阿里云 CDN 专项处理

不同 CDN 提供商使用不同字段传递真实 IP,需针对性适配:

  • Cloudflare:使用 HTTP_CF_CONNECTING_IP 字段
  • 阿里云 CDN:使用 HTTP_X_REAL_IP 或 HTTP_ALI_SWIFT_CLIENT_IP
  • 腾讯云 CDN:使用 HTTP_CLIENT_IP 或 HTTP_X_FORWARDED_FOR
<?php
function getCDNClientIP($cdnProvider = '') {
    $ip = '';
    // 根据 CDN 类型优先检查
    switch ($cdnProvider) {
        case 'cloudflare':
            if (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {
                $ip = $_SERVER['HTTP_CF_CONNECTING_IP'];
            }
            break;
        case 'aliyun':
            if (!empty($_SERVER['HTTP_ALI_SWIFT_CLIENT_IP'])) {
                $ip = $_SERVER['HTTP_ALI_SWIFT_CLIENT_IP'];
            } elseif (!empty($_SERVER['HTTP_X_REAL_IP'])) {
                $ip = $_SERVER['HTTP_X_REAL_IP'];
            }
            break;
        case 'tencent':
            if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
                $ip = $_SERVER['HTTP_CLIENT_IP'];
            }
            break;
    }
    // 兜底方案(不依赖 CDN 字段)
    if (!$ip || is_private_ip($ip)) {
        $ip = getClientIP(); // 调用上文标准检测法
    }
    return $ip;
}
?>

实践建议:

  1. 在 CDN 控制台开启 “真实客户端 IP 透传” 功能
  2. 在 Nginx 中配置 set_real_ip_from 白名单,防止伪造头注入
  3. 记录日志时优先输出 CDN 透传字段(如 $_SERVER['HTTP_X_FORWARDED_FOR'])

3. IPv6 专用检测:兼容 IPv4/IPv6 双栈

IPv6 地址格式复杂(含 :: 压缩、IPv4 映射地址等),需特殊处理:

  • IPv4 映射 IPv6:如 ::ffff:192.168.1.1 应提取后段 IPv4
  • IPv6 内网地址:fc00::/7(唯一本地地址)、fe80::/10(链路本地地址)需过滤
<?php
function getIPv6ClientIP() {
    // 处理 IPv4 映射 IPv6 地址
    $ip = '';
    if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ips = array_map('trim', explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']));
        foreach ($ips as $candidate) {
            // 移除 IPv4 映射前缀 ::ffff:
            $cleanIP = preg_replace('/^::ffff:/', '', $candidate);
            if (filter_var($cleanIP, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
                $ip = $cleanIP;
                break;
            }
        }
    }
    if (!$ip && !empty($_SERVER['REMOTE_ADDR'])) {
        $ip = preg_replace('/^::ffff:/', '', $_SERVER['REMOTE_ADDR']);
    }
    return $ip ?: 'unknown';
}
function is_private_ipv6($ip) {
    $ip = strtolower($ip);
    return preg_match('/^(fc[0-9a-f]|fe[89ab])/', $ip) || $ip === '::1';
}
?>

IPv6 安全提示:

  • 部分防火墙对 IPv6 放行更宽松,需同步配置 IPv6 ACL
  • 使用 inet_pton() 处理二进制 IP(避免字符串比较漏洞)
  • 数据库字段建议使用 VARBINARY(16) 存储 IPv6(比 VARCHAR 更高效)

三、IP 伪造风险与防护策略

1. 常见伪造手法

  • 直接修改请求头:攻击者在 HTTP 请求中添加 X-Forwarded-For: 1.2.3.4
  • 利用不安全代理:通过开放代理服务器转发请求,注入虚假头
  • Cookie/JS 伪装:配合 JavaScript 动态注入 IP(需后端验证)

⚠️ REMOTE_ADDR 是 TCP 连接层的源 IP,无法被客户端伪造,但可能返回代理服务器 IP。

2. 防护措施(必须组合使用)

① 严格信任代理白名单

仅信任已知代理服务器的 IP,拒绝其他来源的代理头:

<?php
$trusted_proxies = ['192.168.1.100', '10.0.0.50']; // 仅限内部代理 IP
if (in_array($_SERVER['REMOTE_ADDR'], $trusted_proxies)) {
    // 允许检查代理头
    $ip = getHeaderIP();
} else {
    $ip = $_SERVER['REMOTE_ADDR']; // 直接使用原始 IP
}
?>
② 验证 IP 地址合法性

使用 filter_var($ip, FILTER_VALIDATE_IP) 验证格式,并结合 ip2long() 检查 IP 范围:

<?php
function isValidIP($ip) {
    if (!filter_var($ip, FILTER_VALIDATE_IP)) return false;
    if ($ip === '0.0.0.0' || $ip === '::') return false;
    if (ip2long($ip) === -1) return false; // IPv6 转换异常
    return true;
}
?>
③ 记录完整请求链路

保存所有代理头字段及原始连接 IP,便于事后追溯:

<?php
$logData = [
    'real_ip' => $_SERVER['REMOTE_ADDR'],
    'x_forwarded_for' => $_SERVER['HTTP_X_FORWARDED_FOR'] ?? null,
    'x_real_ip' => $_SERVER['HTTP_X_REAL_IP'] ?? null,
    'client_ip' => $_SERVER['HTTP_CLIENT_IP'] ?? null
];
file_put_contents('ip_log.txt', json_encode($logData) . PHP_EOL, FILE_APPEND);
?>

3. 高级防御:IP 指纹与行为分析

除 IP 地址外,建议结合以下信息交叉验证:

  • User-Agent + Accept-Language:伪造 IP 通常难以同步伪造完整浏览器特征
  • TCP 指纹:通过 SYN 包特征识别设备类型(需底层支持)
  • 地理一致性:若 IP 归属地与用户注册地差异过大,触发二次验证
  • 时间窗口分析:同一 IP 短时高频访问(如每秒 10 次)大概率是爬虫

示例:结合 IP 与 User-Agent 的简单风控逻辑:

<?php
function detectSuspiciousActivity($ip, $ua) {
    // 禁用常见爬虫 UA
    $blocked_agents = ['python-requests', 'curl/', 'wget/', 'libwww-perl'];
    foreach ($blocked_agents as $agent) {
        if (stripos($ua, $agent) !== false) {
            return ['flag' => true, 'reason' => 'suspicious_ua'];
        }
    }
    // 检查 IP 是否属于已知恶意范围(需对接威胁情报 API)
    // 示例:https://www.spamhaus.org/lookup/
    return ['flag' => false];
}
?>

四、进阶技巧与实战场景

1. 访问日志中 IP 的正确记录方式

在 Nginx 中配置日志格式,优先输出代理头:

log_format access_json escape=json '{'
    '"time_local":"$time_local",'
    '"remote_addr":"$proxy_add_x_forwarded_for",'
    '"xff":"$http_x_forwarded_for",'
    '"real_ip":"$remote_addr",'
    '"request":"$request",'
    '"status":$status'
'}';
access_log /var/log/nginx/access.log access_json;

关键字段说明:

  • $proxy_add_x_forwarded_for:在现有 X-Forwarded-For 后追加客户端 IP
  • $http_x_forwarded_for:原始客户端请求头(可能被篡改)
  • $remote_addr:TCP 连接源 IP(最可靠)

2. 数据库存储优化

存储方案 字段类型 优势 适用场景
IPv4 INT UNSIGNED 存储高效(4 字节),支持范围查询 传统单栈 IPv4 网站
IPv6 VARBINARY(16) 支持 IPv6 全格式,节省空间(16 字节) 双栈网站
混合存储 CHAR(39) + ENUM('v4','v6') 兼容性强,便于调试 过渡期项目

插入示例(MySQL):

INSERT INTO logs (ip_binary, ip_type)
VALUES (
    INET6_ATON('2001:db8::1'),
    'v6'
);

查询示例:

SELECT INET6_NTOA(ip_binary) AS readable_ip
FROM logs
WHERE ip_type = 'v6'
AND INET6_ATON(ip_binary) BETWEEN INET6_ATON('2001:db8::') AND INET6_ATON('2001:db8::ffff:ffff:ffff:ffff');

3. 性能优化:IP 解析缓存

IP 地理位置查询(如 GeoIP)是耗时操作,建议:

  1. 使用本地 GeoIP2 数据库(MaxMind)替代在线 API
  2. 对同一 IP 的解析结果缓存 24 小时
  3. 使用 Redis 存储热点 IP 的归属地(如 CDN IP 段)
<?php
function getGeoLocation($ip) {
    $cacheKey = "geo:{$ip}";
    $geo = redis_get($cacheKey);
    if (!$geo) {
        $reader = new GeoIp2\Database\Reader('/data/GeoLite2-City.mmdb');
        $record = $reader->city($ip);
        $geo = [
            'country' => $record->country->isoCode,
            'city' => $record->city->name,
            'lat' => $record->location->latitude,
            'lon' => $record->location->longitude
        ];
        redis_setex($cacheKey, 86400, json_encode($geo));
    }
    return json_decode($geo, true);
}
?>

五、网友最关心的 10 个问题深度解答

1. 为什么 $_SERVER['REMOTE_ADDR'] 返回的是 127.0.0.1?

常见于本地开发环境使用 Nginx 作为反向代理时。解决方法:

  • 在 Nginx 配置中添加: proxy_set_header X-Real-IP $remote_addr;
  • 在 PHP 中优先检查 HTTP_X_REAL_IP
  • 开发环境可临时忽略代理头,直接使用 REMOTE_ADDR

2. 如何防止用户伪造 IP 地址绕过风控?

三层防御体系:

  1. 前端:使用 WebRTC 或 Canvas 指纹获取真实网络信息(需用户授权)
  2. 后端:结合 IP + User-Agent + 时间窗口 + 行为序列分析
  3. 基础设施:在 CDN/Nginx 层配置 IP 信誉库(如 Cloudflare Firewall Rules)

示例:检测异常访问模式的伪代码:

// 若同一 IP 在 1 分钟内请求 >50 次,且 User-Agent 含 'bot'
if ($request_count > 50 && stripos($ua, 'bot') !== false) {
    trigger_fraud_alert($ip);
}

3. IPv6 地址在 PHP 中如何转换为整数?

IPv6 无法直接用 ip2long() 处理,需使用 inet_pton() 转为二进制再转整数:

<?php
function ipv6_to_int($ip) {
    $packed = inet_pton($ip);
    if ($packed === false) return 0;
    $parts = unpack('N*', $packed);
    return array_sum(array_map(function($val, $idx) {
        return $val * pow(2, 32 * (count($parts) - $idx - 1));
    }, $parts, array_keys($parts));
}
?>

4. 如何区分内网 IP 和公网 IP?

使用标准函数 filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE):

<?php
function isPublicIP($ip) {
    return filter_var($ip, FILTER_VALIDATE_IP,
        FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE) !== false;
}
?>

5. CDN 代理下,PHP 如何获取真实客户端 IP?

按以下顺序处理:

  1. 检查 Cloudflare:读取 HTTP_CF_CONNECTING_IP
  2. 检查阿里云:读取 HTTP_ALI_SWIFT_CLIENT_IP
  3. 检查腾讯云:读取 HTTP_CLIENT_IP
  4. 回退至 REMOTE_ADDR
  5. 验证是否为合法公网 IP

6. 为什么某些 IP 无法解析地理位置?

常见原因:

  • IP 属于未分配地址(如 192.0.2.0/24 文档保留段)
  • 企业私有网络 IP(如 100.64.0.0/10 CGNAT 地址)
  • IPv6 本地链路地址(如 fe80::/10)
  • GeoIP 数据库未收录的小型 ISP

建议:对无法解析的 IP 标记为 unknown,不强制填充默认值。

7. 如何处理多层代理的 X-Forwarded-For 头?

安全做法:取第一个非内网 IP(最接近用户):

<?php
function getRealIPFromXFF($xff) {
    $ips = array_map('trim', explode(',', $xff));
    foreach ($ips as $ip) {
        if (filter_var($ip, FILTER_VALIDATE_IP) && !is_private_ip($ip)) {
            return $ip;
        }
    }
    return null;
}
?>

⚠️ 绝对不要取最后一个 IP(可能是代理服务器)!

8. 为什么同一用户在不同页面显示不同 IP?

可能原因:

  • 用户切换网络(如 Wi-Fi → 4G)
  • CDN 边缘节点动态切换
  • 负载均衡器轮询后端服务器
  • 浏览器启用隐私模式(使用不同代理)

解决方案:结合 Session ID + User-Agent 进行用户唯一性标识。

9. 如何在 PHP 中测试 IP 获取逻辑?

使用 curl 模拟不同请求头:

# 模拟 Cloudflare 请求
curl -H "CF-Connecting-IP: 203.0.113.45" \
     -H "X-Forwarded-For: 203.0.113.45, 10.0.0.1" \
     http://example.com/ip-check.php
# 模拟伪造攻击
curl -H "X-Forwarded-For: 127.0.0.1" \
     http://example.com/ip-check.php

输出日志验证字段值是否符合预期。

10. 如何在不暴露真实 IP 的情况下进行开发?

推荐方案:

  • 使用 Docker 容器网络:宿主机 IP 作为代理入口
  • 配置本地 hosts:将域名指向 127.0.0.1
  • 开发环境禁用代理头验证(仅用于测试)
  • 使用 ngrok 等内网穿透工具生成临时公网地址