支持多语言准确率99.9%的开源离线IP地址定位库Ip2region ，强大到离谱

前言

是不是有很多同学都有过查询ip地址的需求呢，比如文章发布地归属，又或者是实时地位等等。当然，这些需求可以调用其他有偿的API实现，但是需要收费呀。今天我们就分享一个离线的IP地址定位库，其支持多种语言链接查询，并且准确率高达99.9%，简直不要太好。如果你有类似的需求，并且能够容忍这极小的误差率，我觉得可以一试。

1、技术积累

1.1 Ip2region 是什么

ip2region - 是一个离线IP地址定位库和IP定位数据管理框架，10微秒级别的查询效率，提供了众多主流编程语言的 xdb 数据生成和查询客户端实现。

1.2 Ip2region 特性

1.2.1 IP 数据管理框架
xdb 支持亿级别的 IP 数据段行数，默认的 region 信息都固定了格式：国家|区域|省份|城市|ISP，缺省的地域信息默认是0。 region 信息支持完全自定义，例如：你可以在 region 中追加特定业务需求的数据，例如：GPS信息/国际统一地域信息编码/邮编等。也就是你完全可以使用 ip2region 来管理你自己的 IP 定位数据。
1.2.2 数据去重和压缩
xdb 格式生成程序会自动去重和压缩部分数据，默认的全部 IP 数据，生成的 ip2region.xdb 数据库是 11MiB，随着数据的详细度增加数据库的大小也慢慢增大。

1.3 极速查询响应

即使是完全基于 xdb 文件的查询，单次查询响应时间在十微秒级别，可通过如下两种方式开启内存加速查询：
1.3.1 vIndex 索引缓存 ：使用固定的 512KiB 的内存空间缓存 vector index 数据，减少一次 IO 磁盘操作，保持平均查询效率稳定在10-20微秒之间。
1.3.2 xdb 整个文件缓存：将整个 xdb 文件全部加载到内存，内存占用等同于 xdb 文件大小，无磁盘 IO 操作，保持微秒级别的查询效率。

1.4 Ip2region 支持语言与API

2、实战演示

我们以java为例，实战演示一下通过这个离线库获取到本机的外网IP归属地。

2.1 准备工作

我们需要从ip2region git仓库将离线库下载到本地
https://gitee.com/lionsoul/ip2region/tree/master/data

2.2 引入maven依赖

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

2.3 完全基于文件的查询

import org.lionsoul.ip2region.xdb.Searcher;
import java.io.*;
import java.util.concurrent.TimeUnit;

public class SearcherTest {
    public static void main(String[] args) {
        // 1、创建 searcher 对象
        String dbPath = "ip2region.xdb file path";
        Searcher searcher = null;
        try {
            searcher = Searcher.newWithFileOnly(dbPath);
        } catch (IOException e) {
            System.out.printf("failed to create searcher with `%s`: %s\n", dbPath, e);
            return;
        }

        // 2、查询
        try {
            String ip = "1.2.3.4";
            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 对象单独使用。
    }
}

3、测试用例

3.1 找出本地的外网归属地进行验证

3.2 运行我们本地代码进行验证

4、总结

经过引入和验证Ip2region 获取本地外网IP归属，发现准确率还是可以的，应该可以达到开发者所说的99.9%。最最主要该IP定位库完全开源，再也不用向收费API低头了。那么，如果你的项目上能够接受这极小的误差性还是可以的哦，赶紧GET起来吧！