萬盛學電腦網

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

PHP 取得客戶端真實 IP 地址(支援代理、CDN、IPv6)

完整函數

<?php
function getClientIp(): string
{
    $headers = [
        'HTTP_CF_CONNECTING_IP',   // Cloudflare
        'HTTP_CLIENT_IP',          // 標準代理
        'HTTP_X_FORWARDED_FOR',    // 常見代理鏈 (可能包含多個 IP,取第一個)
        'HTTP_X_REAL_IP',          // Nginx proxy_set_header
        'REMOTE_ADDR',             // 直接連線
    ];

    foreach ($headers as $header) {
        $value = $_SERVER[$header] ?? '';
        if ($value) {
            // X-Forwarded-For 可能為 "client, proxy1, proxy2"
            $ips = array_map('trim', explode(',', $value));
            foreach ($ips as $ip) {
                if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                    return $ip;
                }
            }
        }
    }
    return 'unknown';
}
?>

關鍵點解析

  • 信任鏈順序:優先信任 CDN (Cloudflare) 注入的標頭,再到標準代理標頭,最後才是 REMOTE_ADDR。
  • 過濾私有/保留 IP:FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE 排除 10.x、192.168.x、127.x 等內網 IP。
  • X-Forwarded-For 取第一個:最左側為原始客戶端 IP(前提是代理正確追加)。
  • IPv6 支援:filter_var 自動支援 IPv6 格式驗證。

Nginx/Apache 設定配合

# Nginx
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

# Apache (mod_remoteip)
RemoteIPHeader X-Forwarded-For
RemoteIPInternalProxy 10.0.0.0/8 192.168.0.0/16

安全警示

若伺服器前無可信代理/CDN,直接使用 $_SERVER['REMOTE_ADDR'],否則攻擊者可偽造 X-Forwarded-For 繞過 IP 限制。

儲存建議

  • 資料庫欄位:VARBINARY(16) 存儲 inet_pton() 二進位,或 VARCHAR(45) 存字串(支援 IPv6)。
  • 記錄時間戳、User-Agent 供審計分析。
copyright © 萬盛學電腦網 all rights reserved