Appearance
ip.taobao.com 打不开了?老教程里的免费 IP 接口现状实测与 PHP 迁移方案
前几天帮一个做 SaaS 的朋友看日志,发现后台的「登录地」一列全是空的。翻代码,getIpInfo 这个函数调的是 http://ip.taobao.com/service/getIpInfo.php——这是 2019 年那批教程里的标准写法,当年确实好用。现在它返回的东西,日志里只留了一句 HTTP 404。
免费接口「用着用着就没了」,是国内开发者绕不开的一件事。这篇把几个老牌免费接口今天的实际表现跑一遍,再给一份 PHP 的迁移方案——老项目里 PHP 代码最多,先把这批理干净最划算。
一、今天实测:老接口都什么状态
淘宝 IP 库(ip.taobao.com):接口已下线。
text
$ curl -sL -o /dev/null -w 'final=%{url_effective} code=%{http_code}\n' \
"http://ip.taobao.com/service/getIpInfo.php?ip=223.5.5.5"
final=https://ip.taobao.com/service/getIpInfo.php?ip=223.5.5.5 code=404http 请求先吃一个 301 跳到 https,跟过去是 404,连站点首页也没有可用内容。这个接口当年还有个隐藏毛病:文档写着能用,实际有 QPS≈1 的限制,量稍微大一点就开始给你返回失败——这也是当年大家一边用一边骂的原因。现在连骂的机会都没了。注意 curl 不加 -L 只会看到 301,很容易误判成「接口还在,只是换了地址」,排查时一定跟到底。
搜狐 pv.sohu.com/cityjson:还能返回数据,但它压根不支持「查指定 IP」。
text
$ curl -s -H 'User-Agent: Mozilla/5.0' "http://pv.sohu.com/cityjson?ie=utf-8"
var returnCitySN = {"cip": "42.81.252.245", "cid": "120000", "cname": "天津市"};
$ php ipgeo.php --legacy # 服务器端再跑一次,同一个 URL
HTTP 200, body: var returnCitySN = {"cip": "127.0.0.1", "cid": "00", "cname": "未知"};两次调用,一次拿到天津,一次拿到 127.0.0.1。**因为它返回的永远是「请求方自己的 IP」,根本没有 ?ip= 这个参数。**把它用在服务端做日志地域统计,你得到的其实是服务器的出口位置;用在浏览器里倒是对的,但那是另一种用法了。顺带一提,它输出的是 JS 变量赋值而不是 JSON,得正则去抠,还得处理 GBK 编码。
ip-api.com:目前仍然可用。 免费版返回中文,还带 AS 号,实测响应很快。代价是免费版只开放 http(不是 https),有每分钟调用次数限制,并且对商业用途有限制,落地前建议去官网确认最新条款。
为什么这些接口会一个个消失?因为它们本来是自家业务的副产品:没有文档维护、没有 SLA、没有收费模式,业务一调整就顺手关了。对生产环境来说,这类接口只能当临时方案,不能当基础设施。
二、迁移先做一件事:把查询收口成一个函数
迁移最怕的不是改代码,而是「接口地址散落在项目各处」。先搜一遍:
bash
$ grep -rn --exclude-dir=vendor --exclude-dir=node_modules \
-e 'ip\.taobao\.com' -e 'pv\.sohu\.com' -e 'getIpInfo' -e 'cityjson' .搜索结果通常分三类:业务代码、第三方插件/主题、以及配置文件。第三类最容易漏——很多 WordPress 插件、Discuz 插件把接口地址写在配置里,你改了自己的代码,评论区的归属地还是空的。
搜完之后的目标很明确:全项目只剩一个函数在发这个 HTTP 请求,其他地方都调它。这样以后接口再换,只改一处。
三、PHP 迁移实现:一个函数 + 缓存 + 限速
下面这份代码可以直接替换掉旧函数。它做了三件老代码通常没做的事:把响应统一成一套结构、把错误分门别类、加了本地缓存和串行限速。
php
<?php
/**
* ipgeo.php —— 把老教程里的免费 IP 接口换成还能用的(PHP 迁移版)
* 用法: php ipgeo.php 223.5.5.5
* php ipgeo.php # 查当前请求方 IP
* php ipgeo.php --legacy # 顺便演示老接口现在的表现
*/
declare(strict_types=1);
const IP9_API = 'https://ip9.com.cn/get';
const CACHE_DIR = __DIR__ . '/ipgeo_cache';
const MIN_GAP = 1.1; // 免费版 60 次/分钟/IP,串行留点余量
const UA = 'Mozilla/5.0 (compatible; ipgeo/1.0)';
function http_get(string $url, int $timeout = 3): array
{
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => $timeout,
CURLOPT_CONNECTTIMEOUT => 2,
CURLOPT_FOLLOWLOCATION => false, // 旧域名跳转要看得见,别被 301 悄悄带走
CURLOPT_USERAGENT => UA,
CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$err = curl_error($ch);
curl_close($ch);
if ($body === false) {
throw new RuntimeException("curl 失败: {$err}");
}
return ['code' => $code, 'body' => (string)$body];
}
/** 查询指定 IP(或当前请求方 IP),返回统一结构 */
function ipgeo(string $ip = ''): array
{
if ($ip !== '') {
// 内网地址不用查,接口也查不出有意义的结果
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE) === false) {
return ['ok' => false, 'ip' => $ip, 'err' => '不是可查询的公网 IP'];
}
if ($hit = cache_get($ip)) {
$hit['cached'] = true;
return $hit;
}
}
pace();
$url = IP9_API . ($ip !== '' ? '?ip=' . rawurlencode($ip) : '');
try {
['code' => $code, 'body' => $body] = http_get($url);
} catch (RuntimeException $e) {
return ['ok' => false, 'ip' => $ip, 'err' => $e->getMessage()];
}
if ($code !== 200) {
return ['ok' => false, 'ip' => $ip, 'err' => "HTTP {$code}"];
}
$res = json_decode($body, true);
if (!is_array($res)) {
return ['ok' => false, 'ip' => $ip, 'err' => '返回不是合法 JSON'];
}
$ret = $res['ret'] ?? 0;
if ($ret === 400) {
$out = ['ok' => false, 'ip' => $ip, 'err' => 'IP 格式不合法 (ret=400)'];
cache_put($ip, $out); // 确定的结果,可以缓存
return $out;
}
if ($ret === 429) {
return ['ok' => false, 'ip' => $ip, 'err' => '触发频率限制 (ret=429),请放慢节奏'];
}
if ($ret !== 200 || !is_array($res['data'] ?? null)) {
return ['ok' => false, 'ip' => $ip, 'err' => "接口异常 (ret={$ret})"];
}
$d = $res['data'];
$out = [
'ok' => true,
'ip' => $d['ip'] ?? '',
'country' => $d['country'] ?? '',
'prov' => $d['prov'] ?? '',
'city' => $d['city'] ?? '',
'isp' => $d['isp'] ?? '',
'lng' => $d['lng'] ?? '',
'lat' => $d['lat'] ?? '',
'post' => $d['post_code'] ?? '',
'callno' => $d['area_code'] ?? '', // 区号
'area' => $d['area'] ?? '', // 区县:VIP 版字段,免费版为空
];
if ($ip !== '') {
cache_put($ip, $out);
}
return $out;
}
function cache_path(string $ip): string
{
return CACHE_DIR . '/' . md5($ip) . '.json';
}
function cache_get(string $ip): ?array
{
$f = cache_path($ip);
if (!is_file($f) || filemtime($f) < time() - 86400) { // 一天过期
return null;
}
$d = json_decode((string)file_get_contents($f), true);
return is_array($d) ? $d : null;
}
function cache_put(string $ip, array $row): void
{
if (!is_dir(CACHE_DIR)) {
mkdir(CACHE_DIR, 0775, true);
}
$f = cache_path($ip);
file_put_contents($f . '.tmp', json_encode($row, JSON_UNESCAPED_UNICODE), LOCK_EX);
rename($f . '.tmp', $f); // 原子替换,别写一半
}
/** 简单串行限速,避免触发 429 */
function pace(): void
{
$stamp = CACHE_DIR . '/.last';
$last = is_file($stamp) ? (float)file_get_contents($stamp) : 0.0;
$gap = microtime(true) - $last;
if ($gap < MIN_GAP) {
usleep((int)((MIN_GAP - $gap) * 1000000));
}
if (!is_dir(CACHE_DIR)) {
mkdir(CACHE_DIR, 0775, true);
}
file_put_contents($stamp, (string)microtime(true));
}
function render(array $r): string
{
if (!$r['ok']) {
return sprintf('[失败] %s %s', $r['ip'] !== '' ? $r['ip'] : '当前IP', $r['err']);
}
$flag = !empty($r['cached']) ? ' (缓存)' : '';
return sprintf(
'%s 国家=%s 省=%s 市=%s 运营商=%s 邮编=%s 区号=%s%s',
$r['ip'], $r['country'], $r['prov'], $r['city'], $r['isp'], $r['post'], $r['callno'], $flag
);
}
$argv = $_SERVER['argv'] ?? [];
$ip = $argv[1] ?? '';
echo render(ipgeo($ip)), PHP_EOL;实跑输出:
text
$ php ipgeo.php 223.5.5.5
223.5.5.5 国家=中国 省=浙江 市=杭州 运营商=AliDNS/DoH/DoT/阿里云 邮编=310000 区号=0571
$ php ipgeo.php 223.5.5.5
223.5.5.5 国家=中国 省=浙江 市=杭州 运营商=AliDNS/DoH/DoT/阿里云 邮编=310000 区号=0571 (缓存)
$ php ipgeo.php 999.1.1.1
[失败] 999.1.1.1 不是可查询的公网 IP
$ php ipgeo.php 192.168.1.10
[失败] 192.168.1.10 不是可查询的公网 IP第二次调用直接吃缓存,没有再发请求;非法 IP 和内网 IP 在本地就拦掉了,不会浪费一次调用。
四、迁移时最容易翻车的几个地方
别用 file_get_contents 直接发请求。 老代码里很常见,问题是它没有默认超时——目标站点挂起时,你的 PHP 进程会一直等下去,几秒内就能把 php-fpm 占满。用 cURL 并显式设置 CURLOPT_TIMEOUT、CURLOPT_CONNECTTIMEOUT。
老接口的输出通常要转码。 搜狐那类接口给的是 GBK,如果你的项目是 UTF-8,不转码就会出现「娴欐睙」式的乱码,还会连带把数据库的字段写成半截字符。迁移到 JSON 接口之后这段转码逻辑要删掉,不然是双重转换。
正则解析换成 json_decode,但别忘 JSON_UNESCAPED_UNICODE。 不带的后果是「浙江」变成 \u6d59\u6c5f 存进库,后面搜索、分组统计全乱。
存量数据回填要限速。 数据库里攒了几万条只有 IP、没有归属地的老记录,很多人写个循环直接刷——免费接口按 60 次/分钟/IP 限速,刷快了就是一路 429。正确做法是串行 + 间隔(上面代码里的 MIN_GAP 就是干这个的)+ 结果落盘缓存,跑不完下次接着跑。
给失败留一条可见的路。 老代码的典型问题是「查不到就显示空」,然后所有人都以为数据本来就缺。迁移时顺手加个统计:把 ret != 200、超时、非法 IP 的比例打点到日志,出问题时一眼能看出是接口挂了还是数据源本身脏。
插件里的调用要一起改。 前面 grep 出来的第三方插件、主题,很多在自己的配置里存了老接口地址。改完主项目记得回归一遍评论区、后台用户列表这些「顺带显示归属地」的位置。
总结
老免费接口的现状是:淘宝 IP 库已经下线(301 → 404),搜狐接口只能返回请求方自己的 IP、不适合服务端批量查询,ip-api.com 还活着但免费版有协议和次数限制。这类接口适合学习和临时验证,不适合放在生产链路里当基础设施。
迁移的思路不是「换一个域名继续用」,而是把查询收口成一个函数,然后把缓存、限速、错误分类补齐——这三样才是老代码真正缺的东西。新的实现就一个 GET:https://ip9.com.cn/get?ip=<IP>(不传参数返回当前请求方 IP,IPv4/IPv6 均支持),免费版无需注册、60 次/分钟/IP,返回国家、省市、邮编、区号、运营商、经纬度(城市中心)等字段;区县、ip_type、ip_asn 属于 VIP 版能力,具体以官网 https://www.ip9.com.cn 为准。