结论：应优先通过ip -4 route | grep default | awk '{print $3}'获取默认路由网卡IP，再fallback到hostname -I中首个非私有IPv4地址，最后用gethostbyname(gethostname())兜底；需显式过滤127.0.0.0/8、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16等私有地址。
PHP 获取本机 IP 时返回多个私有地址，怎么挑一个可用的？
直接说结论：PHP 本身没有“本机 IP”的内置概念，$_SERVER 里一堆 REMOTE_ADDR、SERVER_ADDR、HTTP_X_FORWARDED_FOR 等字段，混在一起容易误选。所谓“多个私有 IP”，通常是程序在 Docker 容器、Nginx 反向代理、云主机内网环境里读到了 127.0.0.1、172.17.0.1、192.168.0.1 这类地址，但你真正想用的是能被外部访问的那个（比如绑定到公网的网卡 IP）。
哪些 $_SERVER 字段常被误当成本机 IP？
常见错误是把以下字段直接当成本机出口 IP：
-
$_SERVER['SERVER_ADDR']：Web 服务监听的 IP，可能是0.0.0.0或内网地址，不反映实际出口 -
$_SERVER['REMOTE_ADDR']：客户端 IP，不是本机 IP -
$_SERVER['HTTP_X_FORWARDED_FOR']：可伪造，且是客户端链路 IP，跟本机无关
真正靠谱的只有：gethostbyname(gethostname())，但它在容器或 hosts 配置异常时可能返回 127.0.0.1；更稳的方式是查系统网卡。
用 shell 命令辅助获取真实出口网卡 IP（Linux）
PHP 无法跨平台可靠枚举网卡，但多数生产环境是 Linux，可以用 ip 命令过滤出非回环、非 docker/bridge 的主网卡 IP：
立即学习“PHP免费学习笔记（深入）”；
exec("ip -4 route | grep 'default' | awk '{print $3}' 2>/dev/null", $out);
如果返回空，再 fallback 到：
exec("hostname -I | awk '{print $1}' 2>/dev/null", $out);
注意：hostname -I 会返回所有 IPv4 地址（含 172.18.x.x），但顺序通常按网卡注册顺序，第一个非 127.0.0.1 的大概率是你要的。需手动过滤：
- 排除
127.0.0.1 - 排除
172.[16-31].x.x、192.168.x.x、10.x.x.x（除非你明确要内网 IP） - 优先保留有默认路由指向的 IP（即上面
ip -4 route返回的那个）
PHP 实现优先级选取逻辑（推荐代码片段）
下面这段逻辑兼顾兼容性与准确性，适用于大多数 Linux + Nginx + PHP-FPM 场景：
$ip = null;
// 1. 尝试从默认路由获取（最可信）
exec("ip -4 route | grep default | head -n1 | awk '{print \$3}' 2>/dev/null", $route_out);
if (!empty($route_out[0]) && filter_var($route_out[0], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
$ip = $route_out[0];
}
// 2. fallback：取 hostname -I 的第一个非私有 IP
if (empty($ip)) {
exec("hostname -I 2>/dev/null", $host_out);
if (!empty($host_out[0])) {
$ips = array_filter(array_map('trim', explode(' ', $host_out[0])));
foreach ($ips as $candidate) {
if (filter_var($candidate, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) &&
!filter_var($candidate, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
$ip = $candidate;
break;
}
}
}
}
// 3. 最后 fallback：gethostbyname(gethostname())
if (empty($ip)) {
$ip = gethostbyname(gethostname());
if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
$ip = '127.0.0.1';
}
}
关键点：不要依赖单一来源；FILTER_FLAG_NO_PRIV_RANGE 是判断私有 IP 的核心，但它**不包含 172.16.0.0/12 的全部范围**（PHP 旧版本 bug），所以建议显式用正则或 ip_is_private() 辅助判断；另外，exec 在禁用函数环境下会失效，上线前务必确认 disable_functions 没禁掉 exec。
