获取用户IPv4地址失败，返回IPv6地址的问题求助

我在网站中尝试获取用户的IPv4地址，但实际返回了IPv6地址（示例：2a01:cb04:8ed3:b300:d3d:71c1:a883:5b61），期望得到格式如255.255.255.1的IPv4地址。本地环境测试功能正常，但服务器环境失效。当前使用的PHP代码如下：

function get_client_ip()
{
    $ipaddress = '';
    if (isset($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ipaddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
    } else if (isset($_SERVER['HTTP_X_FORWARDED'])) {
        $ipaddress = $_SERVER['HTTP_X_FORWARDED'];
    } else if (isset($_SERVER['HTTP_FORWARDED_FOR'])) {
        $ipaddress = $_SERVER['HTTP_FORWARDED_FOR'];
    } else if (isset($_SERVER['HTTP_FORWARDED'])) {
        $ipaddress = $_SERVER['HTTP_FORWARDED'];
    } else if (isset($_SERVER['REMOTE_ADDR'])) {
        $ipaddress = $_SERVER['REMOTE_ADDR'];
    } else {
        $ipaddress = 'UNKNOWN';
    }
    return $ipaddress;
}

• 核心原因：服务器环境启用了IPv6支持，且网络链路优先走IPv6通道，导致$_SERVER相关变量返回IPv6地址；同时原代码未对IP地址类型做过滤筛选。

• 修改代码，优先提取IPv4地址：
  获取地址后，通过filter_var验证并筛选出IPv4地址，同时处理代理头中可能存在的多地址（逗号分隔）情况：

  function get_client_ip()
  {
      $ipaddress = 'UNKNOWN';
      // 按优先级检查IP来源头
      $ipHeaders = [
          'HTTP_X_FORWARDED_FOR',
          'HTTP_X_FORWARDED',
          'HTTP_FORWARDED_FOR',
          'HTTP_FORWARDED',
          'REMOTE_ADDR'
      ];
  
      foreach ($ipHeaders as $header) {
          if (isset($_SERVER[$header])) {
              // 拆分多IP场景
              $ips = explode(',', $_SERVER[$header]);
              foreach ($ips as $ip) {
                  $cleanIp = trim($ip);
                  // 验证是否为合法IPv4
                  if (filter_var($cleanIp, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
                      return $cleanIp;
                  }
              }
          }
      }
  
      return $ipaddress;
  }
  

• 服务器层面强制IPv4（可选）：
  若业务不需要IPv6支持，可在服务器配置中禁用IPv6监听（比如Nginx/Apache仅绑定IPv4端口），这样所有请求都会通过IPv4连接，REMOTE_ADDR将直接返回IPv4地址。

• 代理头可靠性提示：
  HTTP_X_FORWARDED_FOR等代理头存在被伪造的风险，若需高可信度的客户端IP，优先依赖REMOTE_ADDR，或配合反向代理配置（如Nginx的realip模块）确保传递真实的客户端IPv4地址。

内容的提问来源于stack exchange，提问作者Maxyme Jarrier