萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 取得訪客真實 IP 完整方案:六種方法對比與最佳實踐

核心挑戰

經過反向代理、CDN、負載均衡器時,$_SERVER['REMOTE_ADDR'] 為代理 IP,非用戶真實 IP。需依信任代理層級解析 X-Forwarded-For、X-Real-IP、HTTP_CLIENT_IP。

六種常見寫法對比

方法 1:最簡單(無代理)

$ip = $_SERVER['REMOTE_ADDR'];

方法 2:判斷 VIA 標頭

$ip = $_SERVER['HTTP_VIA'] ? $_SERVER['HTTP_X_FORWARDED_FOR'] : $_SERVER['REMOTE_ADDR'];
$ip = $ip ?: $_SERVER['REMOTE_ADDR'];

方法 3:完整鏈路解析(推薦單機)

function getRealIp() {
    $ip = false;
    if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
        $ip = $_SERVER['HTTP_CLIENT_IP'];
    }
    if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ips = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
        if ($ip) array_unshift($ips, $ip);
        foreach ($ips as $clientIp) {
            $clientIp = trim($clientIp);
            // 排除私有/保留 IP 範圍
            if (!preg_match('/^(10|172\.1[6-9]|172\.2[0-9]|172\.3[0-1]|192\.168)\./', $clientIp)) {
                $ip = $clientIp;
                break;
            }
        }
    }
    return $ip ?: $_SERVER['REMOTE_ADDR'];
}

方法 4:相容舊版 $_SERVER 變數

if ($HTTP_SERVER_VARS['HTTP_X_FORWARDED_FOR']) $ip = $HTTP_SERVER_VARS['HTTP_X_FORWARDED_FOR'];
elseif ($HTTP_SERVER_VARS['HTTP_CLIENT_IP']) $ip = $HTTP_SERVER_VARS['HTTP_CLIENT_IP'];
elseif ($HTTP_SERVER_VARS['REMOTE_ADDR']) $ip = $HTTP_SERVER_VARS['REMOTE_ADDR'];
elseif (getenv('HTTP_X_FORWARDED_FOR')) $ip = getenv('HTTP_X_FORWARDED_FOR');
elseif (getenv('HTTP_CLIENT_IP')) $ip = getenv('HTTP_CLIENT_IP');
elseif (getenv('REMOTE_ADDR')) $ip = getenv('REMOTE_ADDR');
else $ip = 'Unknown';

方法 5:getenv 版本

if (getenv('HTTP_CLIENT_IP')) $ip = getenv('HTTP_CLIENT_IP');
elseif (getenv('HTTP_X_FORWARDED_FOR')) $ip = getenv('HTTP_X_FORWARDED_FOR');
elseif (getenv('REMOTE_ADDR')) $ip = getenv('REMOTE_ADDR');
else $ip = $_SERVER['REMOTE_ADDR'];

方法 6:優先級封裝函式

function getClientIp() {
    $headers = [
        'HTTP_CF_CONNECTING_IP',   // Cloudflare
        'HTTP_X_REAL_IP',          // Nginx proxy_set_header
        'HTTP_X_FORWARDED_FOR',    // 標準代理鏈
        'HTTP_CLIENT_IP',          // 部分代理
        'REMOTE_ADDR'              // 直連
    ];
    foreach ($headers as $h) {
        if (!empty($_SERVER[$h])) {
            $ips = array_map('trim', explode(',', $_SERVER[$h]));
            foreach ($ips as $ip) {
                if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                    return $ip;
                }
            }
        }
    }
    return $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
}

生產環境最佳實踐

  1. 已知代理層數固定:在 Nginx/Apache 設定 set_real_ip_from + real_ip_header,直接讓 REMOTE_ADDR 為真實 IP,PHP 端無需處理。
  2. 使用受信任代理清單:Symfony/Laravel Request::setTrustedProxies() 自動處理。
  3. IPv6 支援:正則/驗證需相容 IPv6 格式。
  4. 記錄完整鏈路:日誌同時存 REMOTE_ADDR、X-Forwarded-For 供審計。

安全提醒

絕不信任 客戶端傳來的 IP 標頭用於權限控制、風控決策,除非你確定該標頭由你控制的邊緣節點設定且不可竄改。

copyright © 萬盛學電腦網 all rights reserved