ip2region.xdb：全网显示 IP 归属地，准确率 99.9%，这个开源的 API 离线库强大到离谱！

当前位置：点晴教程→知识管理交流 →『技术文档交流』

admin

2026年10月14日 9:43 本文热度 114

前言

经常浏览小视频或各类帖子的朋友们可能已经注意到，目前许多网络平台都会显示作者和评论区用户的 IP 归属地。那么，这个功能是如何实现的呢？

某些收费平台的 API

我们可以利用一些付费平台的 API 来实现这一功能，比如一些导航软件的开放平台 API 等。然而，这些服务通常是收费的，而且免费额度有限，适合测试使用，但如果要在生产环境中使用，很可能不够支撑需求。

收费平台 API 示例

离线库推荐

那么，有没有免费的离线 API 库呢？UP 现在推荐一个强大的离线库给大家，一个准确率高达 99.9% 的离线 IP 地址定位库，查询速度仅需 0.0x 毫秒，而且数据库仅 10 兆字节大小。

此库提供了 Java、PHP、C、Python、Node.js、Golang、C# 等多种查询绑定，同时支持 Binary、B 树和内存三种查询算法。

这个库大家可以在 GitHub 上搜索：ip2region，即可找到该开源库。

使用

下面使用 Java 代码给大家演示下如何使用这个 IP 库，该库目前支持多重主流语言。

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

引入依赖
下载离线库文件 ip2region.xdb
简单使用代码

下面，我们通过 Java 代码，挑选某个国内的 IP 进行测试，看看会输出什么样的结果

publicclassIpTest{

    publicstaticvoidmain(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(); // Happyjava
            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，也支持国外的 IP。

其他语言可以参考该开源库的说明文档。

总结

这是一个准确率非常高的离线库，如果项目里有 IP 定位需求的，可以试下该库。

来源：https://juejin.cn/post/7306334713992708122

—END—

该文章在 2026/10/14 9:54:55 编辑过

关键字查询

正在查询...

点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。

点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理，结合码头的业务特点，围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体，是物流码头及其他港口类企业的高效ERP管理信息系统。

点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。

点晴免费OA是一款软件和通用服务都免费，不限功能、不限时间、不限用户的免费OA协同办公管理系统。

ip2region.xdb：全网显示 IP 归属地，准确率 99.9%，这个开源的 API 离线库强大到离谱！

扫码分享