Files

aken1023 2808852e9f Fix IPv4 display and IP detection logic

Improved IP detection and display logic to always show IPv4 format, converting IPv6-mapped IPv4 addresses (e.g., ::ffff:127.0.0.1) and IPv6 loopback (::1) to 127.0.0.1. Updated API endpoint, display components, and added dedicated test/debug pages for IP format and detection. Added documentation summarizing the fixes and new features.

2025-08-01 15:35:15 +08:00

3.0 KiB

Raw Blame History

IP 檢測問題修復總結

問題描述

用戶報告顯示的 IP 地址 ::ffff:127.0.0.1 是錯誤的。這個地址實際上是 IPv4 地址 127.0.0.1（本地回環地址）的 IPv6 映射格式，這通常表示 IP 檢測或顯示邏輯有問題。

問題原因

IPv6 格式處理不完整：雖然 cleanIpAddress 函數有處理 ::ffff: 前綴，但在某些情況下沒有被正確調用
本地回環地址處理：系統返回 ::ffff:127.0.0.1 而不是 127.0.0.1，但顯示邏輯沒有正確轉換
IP 來源檢查不完整：在 API 端點中，當檢測到 127.0.0.1 時，沒有正確處理 IPv6 格式的地址

修復方案

1. 改進 `cleanIpAddress` 函數

在 lib/ip-utils.ts 中添加了對純 IPv6 本地回環地址的處理：

// 處理純IPv6本地回環地址
if (ip === '::1') {
  return '127.0.0.1';
}

2. 增強 `getDetailedIpInfo` 函數

添加了額外的 IPv6 格式檢查邏輯：

// 如果沒有找到任何IP，檢查是否有IPv6格式的地址
if (allFoundIps.length === 0) {
  Object.values(ipSources).forEach(ipSource => {
    if (ipSource) {
      const ipList = ipSource.toString().split(',').map(ip => ip.trim());
      ipList.forEach(ip => {
        // 直接處理IPv6格式的IPv4地址
        if (ip.startsWith('::ffff:')) {
          const cleanIp = ip.substring(7);
          if (isValidIp(cleanIp) && !allFoundIps.includes(cleanIp)) {
            allFoundIps.push(cleanIp);
          }
        }
      });
    }
  });
}

3. 修復 API 端點

在 app/api/ip/route.ts 中改進了 IPv6 格式的處理：

// 處理IPv6格式的IPv4地址
let cleanIp = ip;
if (ip.startsWith('::ffff:')) {
  cleanIp = ip.substring(7);
}
if (cleanIp && cleanIp !== '127.0.0.1' && cleanIp !== '::1' && cleanIp !== 'localhost') {
  clientIp = cleanIp;
  break;
}

4. 創建調試工具

創建了詳細的 IP 調試頁面 (app/test/ip-debug/page.tsx)，可以：

顯示所有檢測到的 IP 地址
顯示 IP 來源詳細信息
顯示原始和最終檢測到的 IP
提供調試信息

測試方法

訪問調試頁面：/test/ip-debug
檢查 API 端點：/api/ip
使用外部測試：/test/ip-test

預期結果

修復後，系統應該：

正確將 ::ffff:127.0.0.1 轉換為 127.0.0.1
正確將 ::1 轉換為 127.0.0.1
在調試頁面中顯示正確的 IP 地址
提供詳細的調試信息幫助診斷問題

本地開發環境說明

在本地開發環境中，顯示 127.0.0.1 是正常的行為，因為：

所有請求都來自本地回環地址
這是正常的開發環境行為
在生產環境中部署後，IP 檢測會更準確

建議

使用 ngrok 進行外部測試：ngrok http 3000
部署到生產環境：在真實環境中測試 IP 檢測功能
檢查網路配置：確保代理伺服器正確設置 IP 轉發頭
使用調試工具：利用新的調試頁面進行問題診斷

3.0 KiB Raw Blame History Unescape Escape