PHP网站客户端有IPv6时仅获取IPv4及IP拦截的解决方案

一、修正Apache监听配置，确保仅接收IPv4请求 #

0.0.0.0:80 是监听所有IPv4网络接口，但如果你的Apache配置中同时存在 Listen [::]:80 这类IPv6监听条目，系统会优先响应IPv6请求。你需要：

• 打开Apache主配置文件（通常是httpd.conf或apache2.conf）
• 查找所有Listen指令，删除或注释掉Listen [::]:80这类IPv6监听条目
• 只保留Listen 0.0.0.0:80（HTTP）和Listen 0.0.0.0:443（HTTPS，若使用）
• 可选：添加IPv6 Off指令到配置文件，强制禁用Apache的IPv6支持
• 重启Apache服务：sudo systemctl restart apache2（Debian/Ubuntu）或sudo systemctl restart httpd（CentOS/RHEL）

二、PHP端优先提取IPv4地址（即使存在IPv6） #

如果网站使用了反向代理（CDN、负载均衡等），$_SERVER['HTTP_X_FORWARDED_FOR']可能包含多个用逗号分隔的IP，你需要拆分后筛选出IPv4地址：

function get_client_ipv4() {
    // 优先从X-Forwarded-For提取（适配反向代理场景）
    if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ips = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
        foreach ($ips as $ip) {
            $ip = trim($ip);
            // 校验是否为合法IPv4地址
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
                return $ip;
            }
        }
    }
    // 若X-Forwarded-For无IPv4，直接取REMOTE_ADDR
    if (filter_var($_SERVER['REMOTE_ADDR'], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
        return $_SERVER['REMOTE_ADDR'];
    }
    // 无可用IPv4时返回空或自定义默认值
    return '';
}

后续的IPv4校验逻辑直接基于这个函数的返回值即可。

三、额外排查点 #

• 检查服务器系统IPv6状态：如果系统本身开启IPv6，即使Apache不监听，客户端仍可能通过其他代理走IPv6访问。可临时禁用系统IPv6：
  • Debian/Ubuntu：编辑/etc/sysctl.conf，添加net.ipv6.conf.all.disable_ipv6 = 1，执行sudo sysctl -p生效
  • CentOS/RHEL：同上编辑/etc/sysctl.conf并执行生效命令
• 确认反向代理配置：若使用Nginx等前置代理，要确保代理仅转发IPv4请求，且X-Forwarded-For仅记录IPv4地址

内容的提问来源于stack exchange，提问作者Nhat Tan