IP 归属地离线库 ip2region：99.9% 准确率，Java 多语言查询实测

前言

经常刷短视频或者逛技术论坛的朋友应该发现了，现在很多平台都会自动显示作者和评论区用户的 IP 归属地。评论区里一句话后面跟着“IP 属地广东”这种标注，早就见怪不怪了。那这功能到底怎么实现的？

说白了，就是把用户的公网 IP 映射到国家、省份、城市这样的粗粒度区域，并不会暴露精确住址。平台要的就是“显示归属地”这个效果，不涉及隐私细节。

收费平台的 API 够不够用？

想实现这个功能，可以用一些付费平台的 API，比如某些导航类开放平台。可问题也很现实：这些服务基本都收费，免费额度少得可怜，测试玩玩还行，真要搬上生产环境，配额大概率撑不住。

从上图的流量限制说明能看出来，IP 定位的个人认证开发者日配额只有 5000 次，企业认证也就 300 万次。对有点规模的业务来说，这点额度真不够看。那有没有免费又靠谱的离线方案？

离线库 ip2region

还真有。给大家推荐一个开源库：ip2region。标称准确率 99.9%，查询速度 0.0x 毫秒级别，数据库文件只有 10MB 左右。

这个开源库提供了 Java、PHP、C、Python、Node.js、Golang、C# 等多种语言的查询绑定，同时支持 Binary、B 树和内存三种查询算法。直接去 GitHub 搜 ip2region 就能找到。

Java 演示怎么用

下面用 Java 代码走一遍基本用法，其他语言可以参考仓库 README。

1. 引入 Maven 依赖

<dependency>
    <groupId>org.lionsoul</groupId>
    <artifactId>ip2region</artifactId>
    <version>2.7.0</version>
</dependency>

2. 下载离线库文件

到 GitHub 仓库 data 目录下载 ip2region.xdb 文件。

3. 编写查询代码

下面是 Java 代码示例，找了国内一个 IP 做测试：

public class IpTest {

    public static void main(String[] args) throws Exception {
        // 1、创建 searcher 对象 (修改为离线库路径)
        String dbPath = "C:\\Users\\Administrator\\Desktop\\ip2region.xdb";
        Searcher searcher = null;
        try {
            searcher = Searcher.newWithFileOnly(dbPath);
        } catch (Exception e) {
            System.out.printf("failed to create searcher with `%s`: %s\n", dbPath, e);
            return;
        }

        // 2、查询
        String ip = "110.242.68.66";
        try {
            long sTime = System.nanoTime();
            String region = searcher.search(ip);
            long cost = TimeUnit.NANOSECONDS.toMicros((long) (System.nanoTime() - sTime));
            System.out.printf("{region: %s, ioCount: %d, took: %d μs}\n", region, searcher.getIOCount(), cost);
        } catch (Exception e) {
            System.out.printf("failed to search(%s): %s\n", ip, e);
        }

        // 3、关闭资源
        searcher.close();

        // 备注：并发使用，每个线程需要创建一个独立的 searcher 对象单独使用。
    }
}

输出结果：

{region: 中国|0|河北省|保定市|联通, ioCount: 3, took: 1192 μs}

region 的格式是 国家|区域|省份|城市|ISP，缺省地域信息默认为 0。

这个库当然也支持国外 IP。

比如查询 93.179.102.140，返回 美国|0|加利福尼亚|0|0，ioCount 为 6，耗时也就 814 微秒。其他语言可以参考该库的说明文档。

总结

如果你项目里有 IP 定位需求，又不想被付费 API 的配额卡脖子，ip2region 这个离线库值得一试。10MB 体量、0.0x 毫秒查询速度、99.9% 准确率，再加上多语言绑定，接入成本真的很低。有类似需求的兄弟也可以去云栈社区交流讨论。

原文来源：稀土掘金