萬盛學電腦網

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

PHP 精準獲取客戶端真實 IP 地址(含代理/負載均衡穿透)

IP 獲取優先級邏輯

客戶端真實 IP 可能藏在多個 Header 中,需按可信度由高到低檢查:

  1. HTTP_CLIENT_IP:共用代理發送(較少見,易偽造)。
  2. HTTP_X_FORWARDED_FOR(XFF):標準代理鏈,**第一個非私有 IP** 為真實客戶端。格式:client, proxy1, proxy2。
  3. HTTP_X_REAL_IP:Nginx proxy_set_header X-Real-IP 設定的單一真實 IP。
  4. REMOTE_ADDR:TCP 連線直接來源(若經過反向代理/負載均衡,此為代理 IP)。

生產級工具函數

<?php
/**
 * 獲取客戶端真實 IP
 * @param array $trustedProxies 受信任代理 IP/CIDR 陣列(如 ['10.0.0.0/8', '192.168.0.0/16'])
 * @return string IPv4/IPv6 或 'unknown'
 */
function getRealClientIp(array $trustedProxies = []): string {
    $headers = [
        'HTTP_CLIENT_IP',
        'HTTP_X_FORWARDED_FOR',
        'HTTP_X_REAL_IP',
        'HTTP_FORWARDED',        // RFC 7239 Forwarded header
        'REMOTE_ADDR',
    ];

    foreach ($headers as $header) {
        if (empty($_SERVER[$header])) continue;

        // X-Forwarded-For 可能包含多個 IP,取第一個非私有 IP
        $ips = array_map('trim', explode(',', $_SERVER[$header]));
        foreach ($ips as $ip) {
            $ip = trim($ip);
            // 移除 port (IPv6 格式 [::1]:port)
            if (str_starts_with($ip, '[')) {
                $ip = substr($ip, 1, strpos($ip, ']') - 1);
            }

            // 驗證 IP 格式
            if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                continue; // 跳過私有/保留 IP
            }

            // 若配置了受信任代理,進一步驗證上一跳是否可信
            if ($trustedProxies && !ipInRanges($_SERVER['REMOTE_ADDR'], $trustedProxies)) {
                continue; // 來源非受信代理,XFF 可能偽造
            }

            return $ip;
        }
    }
    return 'unknown';
}

/** 檢查 IP 是否落在任一 CIDR 範圍內 */
function ipInRanges(string $ip, array $cidrs): bool {
    foreach ($cidrs as $cidr) {
        if (strpos($cidr, '/') === false) $cidr .= '/32'; // 單 IP
        [$rangeIp, $mask] = explode('/', $cidr);
        if (($mask < 0 || $mask > 128)) continue;
        $ipBin = @inet_pton($ip);
        $rangeBin = @inet_pton($rangeIp);
        if ($ipBin === false || $rangeBin === false) continue;
        $bytes = strlen($ipBin);
        $maskBytes = (int)ceil($mask / 8);
        for ($i = 0; $i < $maskBytes; $i++) {
            $bit = $mask - $i * 8;
            $maskByte = $bit >= 8 ? 0xFF : (0xFF << (8 - $bit)) & 0xFF;
            if (($ipBin[$i] & $maskByte) !== ($rangeBin[$i] & $maskByte)) {
                continue 2;
            }
        }
        return true;
    }
    return false;
}

Nginx/Apache 反向代理必要配置

Nginx (nginx.conf 或站點配置):

location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Apache (mod_remoteip):

RemoteIPHeader X-Forwarded-For
RemoteIPInternalProxy 10.0.0.0/8 192.168.0.0/16
# 之後 $_SERVER['REMOTE_ADDR'] 即為真實客戶端 IP

安全警示

  • 切勿直接信任 $_SERVER['HTTP_X_FORWARDED_FOR'],客戶端可任意偽造 Header。
  • 必須在應用層驗證上一跳 (REMOTE_ADDR) 是否為受信任代理,再採信 XFF。
  • 日誌記錄建議同時存儲 REMOTE_ADDR 與解析出的真實 IP,便於審計。
  • IPv6 支援:上述函數已相容 IPv6(inet_pton、filter_var 均支援)。
copyright © 萬盛學電腦網 all rights reserved