萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 與 PHP 依 IP 獲取地理位置:新浪 IP 介面實戰整合

根據 IP 定位地理位置是個性化服務、風控、統計分析的基礎需求。本文展示如何在 Node.js 與 PHP 中呼叫新浪 IP 查詢介面 (int.dpool.sina.com.cn),解析 JSON 回應,獲取國家、省份、城市、ISP 等資訊,並討論生產環境的可靠性考量。

新浪 IP 介面規格

  • 端點:https://int.dpool.sina.com.cn/iplookup/iplookup.php
  • 參數:format=json、ip=目標IP (選填,預設為請求端 IP)
  • 回應格式:JSON 物件

回應欄位說明

欄位說明範例
ret狀態碼:1=成功,0=失敗1
start/endIP 範圍49.68.0.0 / 49.68.255.255
country國家中國
province省份江蘇
city城市徐州
district區/縣(空)
isp網路服務提供商電信/聯通/移動/鐵通/教育網
type/desc類型/描述(通常為空)

Node.js 實作(原生 http 模組)

const http = require('http');
const { promisify } = require('util');

function getIpInfo(ip) {
  return new Promise((resolve, reject) => {
    const url = `https://int.dpool.sina.com.cn/iplookup/iplookup.php?format=json&ip=${encodeURIComponent(ip)}`;
    
    http.get(url, (res) => {
      if (res.statusCode !== 200) {
        return reject(new Error(`HTTP ${res.statusCode}`));
      }
      
      let raw = '';
      res.on('data', chunk => raw += chunk);
      res.on('end', () => {
        try {
          const data = JSON.parse(raw);
          if (data.ret === 1) resolve(data);
          else reject(new Error('查詢失敗:' + JSON.stringify(data)));
        } catch (e) {
          reject(new Error('JSON 解析失敗:' + e.message));
        }
      });
    }).on('error', reject);
  });
}

// 使用範例 (async/await)
(async () => {
  try {
    const info = await getIpInfo('220.181.111.85'); // 百度爬蟲 IP
    console.log(`城市: ${info.city}`);
    console.log(`完整資訊:`, info);
  } catch (err) {
    console.error('查詢錯誤:', err.message);
  }
})();

Node.js 現代寫法:fetch (Node 18+)

async function getIpInfoFetch(ip) {
  const url = `https://int.dpool.sina.com.cn/iplookup/iplookup.php?format=json&ip=${encodeURIComponent(ip)}`;
  const res = await fetch(url);
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const data = await res.json();
  if (data.ret !== 1) throw new Error('查詢失敗');
  return data;
}

PHP 實作

<?php
function getIpInfo($ip) {
  $url = "https://int.dpool.sina.com.cn/iplookup/iplookup.php?format=json&ip=" . urlencode($ip);
  
  $context = stream_context_create([
    'http' => [
      'timeout' => 5, // 秒
      'user_agent' => 'Mozilla/5.0 (compatible; IPGeoBot/1.0)'
    ]
  ]);
  
  $response = @file_get_contents($url, false, $context);
  if ($response === false) {
    return ['error' => '請求失敗'];
  }
  
  $data = json_decode($response, true);
  if (json_last_error() !== JSON_ERROR_NONE) {
    return ['error' => 'JSON 解析失敗'];
  }
  
  return $data;
}

// 使用
$ip = '220.181.111.85';
$result = getIpInfo($ip);
if (isset($result['error'])) {
  echo "錯誤: " . $result['error'];
} else {
  echo "城市: " . $result['city'] . "\n";
  print_r($result);
}
?>

生產環境可靠性考量

風險影響緩解策略
第三方介面不穩定/停止服務功能完全失效備援多個介面 (ip-api.com, ipinfo.io, 高德、騰訊位置服務)
HTTP 明文傳輸資料竊聽、中間人攻擊改用 HTTPS 付費服務
頻率限制大量查詢被封禁本地快取 (Redis)、批次查詢、自建 IP 庫
準確度限制僅能精確到城市/ISP結合 GPS、WiFi 定位、用戶授權精確定位
跨境/VPN/代理 IP定位不準風控結合裝置指紋、行為分析

自建 IP 地址庫方案 (進階)

  1. 下載 ip2region、GeoLite2 (MaxMind)、IPIP.net 等離線資料庫
  2. 匯入 Redis / MySQL / 檔案索引
  3. 本地查詢,微秒級延遲、零外部依賴、完全可控
// ip2region Node.js 範例 (需安裝 ip2region 包)
const { search } = require('ip2region');
const result = search('220.181.111.85');
// { region: '中国|0|江苏|徐州|电信', ... }

總結建議

  • 原型/內部工具:新浪免費介面足夠
  • 生產服務:自建離線資料庫 或採購商業級 API (ipinfo.io, ipapi.co, MaxMind GeoIP2)
  • 架構模式:封裝 IpGeoProvider 介面,支援多供應商切換、快取、降級

IP 定位是「概率性」而非「確定性」資訊,設計系統時務必考慮誤差與不可用情境。

copyright © 萬盛學電腦網 all rights reserved