PHP获客户端IPv6、Node获IPv4，需统一IP验证同一客户端

这种情况通常是因为客户端同时具备IPv4和IPv6地址，加上两边服务的网络环境（比如是否经过反向代理、服务器监听的协议）差异，导致各自获取的IP版本不同。要实现输出一致，可从统一IP获取逻辑或格式转换入手，以下是具体方案：

Node.js 端统一IP版本 #

1. 无反向代理场景 #

直接从请求的socket连接获取原始IP，可判断并提取IPv6，或把IPv4转为IPv6映射格式：

const http = require('http');
const server = http.createServer((req, res) => {
  let clientIp = req.socket.remoteAddress;
  // 统一为IPv6格式：把IPv4转为::ffff:xxx.xxx.xxx.xxx
  if (req.socket.remoteFamily === 'IPv4') {
    clientIp = `::ffff:${clientIp.replace(/^::ffff:/, '')}`;
  }
  res.end(`统一格式IP: ${clientIp}`);
});
server.listen(3000);

2. 反向代理场景（如Nginx） #

先确保Nginx配置正确传递真实IP：

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

再在Node中从请求头提取IP并统一格式：

function getUnifiedIp(req) {
  let ip = req.headers['x-real-ip'] || req.socket.remoteAddress;
  // 转换IPv4为IPv6映射格式
  if (!ip.includes(':') && /^\d+\.\d+\.\d+\.\d+$/.test(ip)) {
    ip = `::ffff:${ip}`;
  }
  return ip;
}

PHP 端统一IP版本 #

1. 无反向代理场景 #

从$_SERVER['REMOTE_ADDR']获取IP，可提取IPv4，或转为IPv6映射格式：

function getUnifiedIp() {
    $ip = $_SERVER['REMOTE_ADDR'];
    // 统一为IPv6格式：把IPv4转为::ffff:xxx.xxx.xxx.xxx
    if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
        return "::ffff:$ip";
    }
    // 提取IPv4：处理IPv6映射格式
    if (str_starts_with($ip, '::ffff:')) {
        return substr($ip, 7);
    }
    return $ip;
}
echo "统一格式IP: " . getUnifiedIp();

2. 反向代理场景 #

先确保代理传递X-Real-IP头，再从请求头获取：

function getUnifiedIp() {
    $ip = $_SERVER['HTTP_X_REAL_IP'] ?? $_SERVER['REMOTE_ADDR'];
    // 格式转换逻辑同上
    if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
        return "::ffff:$ip";
    }
    if (str_starts_with($ip, '::ffff:')) {
        return substr($ip, 7);
    }
    return $ip;
}

核心思路 #

最稳妥的方式是将两边的IP统一为同一格式（比如全部转为IPv6映射格式），这样无论客户端用IPv4还是IPv6发起请求，两边最终输出的IP字符串完全一致，直接对比即可验证是否为同一客户端。

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