經過反向代理、CDN、負載均衡器時,$_SERVER['REMOTE_ADDR'] 為代理 IP,非用戶真實 IP。需依信任代理層級解析 X-Forwarded-For、X-Real-IP、HTTP_CLIENT_IP。
$ip = $_SERVER['REMOTE_ADDR'];
$ip = $_SERVER['HTTP_VIA'] ? $_SERVER['HTTP_X_FORWARDED_FOR'] : $_SERVER['REMOTE_ADDR'];
$ip = $ip ?: $_SERVER['REMOTE_ADDR'];
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'];
}
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';
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'];
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';
}
set_real_ip_from + real_ip_header,直接讓 REMOTE_ADDR 為真實 IP,PHP 端無需處理。Request::setTrustedProxies() 自動處理。REMOTE_ADDR、X-Forwarded-For 供審計。絕不信任 客戶端傳來的 IP 標頭用於權限控制、風控決策,除非你確定該標頭由你控制的邊緣節點設定且不可竄改。