写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 获取真实客户端 IP(并防止伪造)
网络与接口 通用 PHP 7.4+

获取真实客户端 IP(并防止伪造)

REMOTE_ADDR 是唯一可信来源;只有在你确认的可信代理后面,才读取 X-Forwarded-For 的第一段。

完整代码

PHP
<?php
function client_ip(array $trustedProxies = []): string
{
    $remote = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';

    if (!$trustedProxies || !in_array($remote, $trustedProxies, true)) {
        return $remote;
    }

    $xff = $_SERVER['HTTP_X_FORWARDED_FOR'] ?? '';
    if ($xff === '') {
        return $remote;
    }

    foreach (array_reverse(array_map('trim', explode(',', $xff))) as $ip) {
        if (filter_var($ip, FILTER_VALIDATE_IP) === false) {
            continue;
        }
        if (!in_array($ip, $trustedProxies, true)) {
            return $ip;
        }
    }
    return $remote;
}

function ip_int(string $ip): string
{
    $bin = inet_pton($ip);
    return $bin === false ? '0' : bin2hex($bin);
}

怎么用

  1. 直连场景直接调用 client_ip(),不要读 X-Forwarded-For。
  2. 在 Nginx/CLB 后面时,把代理的出口 IP 填进 $trustedProxies。
  3. 存库用 varbinary(16) 存 inet_pton 的结果,比字符串省空间也便于范围查询。

注意

  • X-Forwarded-For 是客户端可伪造的,无条件信任它等于让限流形同虚设。
  • 取最右边第一个「非可信」的地址才相对可靠,因为可信代理会往右追加。
  • IPv6 地址很长,字段别只留 15 个字符。

相关源码