获取真实客户端 IP(并防止伪造)
REMOTE_ADDR 是唯一可信来源;只有在你确认的可信代理后面,才读取 X-Forwarded-For 的第一段。
更新于 2026-11-0630 行代码
完整代码
PHP
<?php
function client_ip(array $trustedProxies = []): string
{
$remote = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
if (!$trustedProxies || !in_array($remote, $trustedProxies, true)) {
return $remote;
}
$xff = $_SERVER['HTTP_X_FORWARDED_FOR'] ?? '';
if ($xff === '') {
return $remote;
}
foreach (array_reverse(array_map('trim', explode(',', $xff))) as $ip) {
if (filter_var($ip, FILTER_VALIDATE_IP) === false) {
continue;
}
if (!in_array($ip, $trustedProxies, true)) {
return $ip;
}
}
return $remote;
}
function ip_int(string $ip): string
{
$bin = inet_pton($ip);
return $bin === false ? '0' : bin2hex($bin);
}
怎么用
- 直连场景直接调用 client_ip(),不要读 X-Forwarded-For。
- 在 Nginx/CLB 后面时,把代理的出口 IP 填进 $trustedProxies。
- 存库用 varbinary(16) 存 inet_pton 的结果,比字符串省空间也便于范围查询。
注意
- X-Forwarded-For 是客户端可伪造的,无条件信任它等于让限流形同虚设。
- 取最右边第一个「非可信」的地址才相对可靠,因为可信代理会往右追加。
- IPv6 地址很长,字段别只留 15 个字符。