客戶端真實 IP 可能藏在多個 Header 中,需按可信度由高到低檢查:
HTTP_CLIENT_IP:共用代理發送(較少見,易偽造)。HTTP_X_FORWARDED_FOR(XFF):標準代理鏈,**第一個非私有 IP** 為真實客戶端。格式:client, proxy1, proxy2。HTTP_X_REAL_IP:Nginx proxy_set_header X-Real-IP 設定的單一真實 IP。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 (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
REMOTE_ADDR 與解析出的真實 IP,便於審計。inet_pton、filter_var 均支援)。