一、简介

IP2Region是一个离线IP地址定位库，可以离线完成IP地址解析，而且准确率极高（官网给出国内IP准确率可达99.9%） ，自身数据库文件也不大，只有几M而已，提供支持多种客户端使用，包括java，php，c，python，nodejs，golang，c#等查询绑定和Binary，B树，内存三种查询算法。

注：项目源码官方Git地址在文章结尾处，请查阅。

二、优势

1、准确率高

99.9%准确率

数据聚合了一些知名ip到地名查询提供商的数据，这些是他们官方的的准确率，经测试着实比经典的纯真IP定位准确一些。
IP2Region的数据聚合自以下服务商的开放API或者数据(升级程序每秒请求次数2到4次):
01， >80%， 淘宝IP地址库，http://ip.taobao.com/
02， ≈10%， GeoIP，https://geoip.com/
03，≈2%，纯真IP库，http://www.cz88.net/
备注：如果上述开放API或者数据都不给开放数据时ip2region将停止数据的更新服务。

2、标准化数据格式

每条ip数据段都固定了格式：

_城市Id|国家|区域|省份|城市|ISP_

只有中国的数据精确到了城市，其他国家有部分数据只能定位到国家，后面的选项全部是0，已经包含了全部你能查到的大大小小的国家（请忽略前面的城市Id，个人项目需求）。

3、体积小

包含了全部的IP，生成的数据库文件ip2region.db只有几MB，最小的版本只有1.5MB，随着数据的详细度增加数据库的大小也慢慢增大，目前还没超过8MB。

4、查询速度快

全部的查询客户端单次查询都在0.x毫秒级别，内置了三种查询算法

memory算法：整个数据库全部载入内存，单次查询都在0.1x毫秒内，C语言的客户端单次查询在0.00x毫秒级别。binary算法：基于二分查找，基于ip2region.db文件，不需要载入内存，单次查询在0.x毫秒级别。b-tree算法：基于btree算法，基于ip2region.db文件，不需要载入内存，单词查询在0.x毫秒级别，比binary算法更快。

任何客户端b-tree都比binary算法快，当然memory算法固然是最快的！

5、多查询客户端支持

已经集成的客户端有：java、C#、php、c、python、nodejs、php扩展(php5和php7)、golang、rust、lua、lua_c, nginx。

各客户端查询性能数据（注：图片数据来源于官网）

（说明：数据及描述来源于官网）

三、应用

IP2Region应用部分本次主要以Java客户端的使用来进行说明。

1、安装引用相关包

IP2Region相关包的Maven仓库引用如下：

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

只需要在pom.xml文件中添加即可！

2、ip2region.db文件添加

将ip2region.db文件作为资源文件添加到项目中，如下图所示：

ip2region.db文件添加示例

注：ip2region.db文件的获取可从官网源码中下载，当然从1.8版本开始，ip2region开源了ip2region.db生成程序的java实现。所以你也可以使用以下命令在本地生成ip2region.db文件。

java -jar dbMaker-{version}.jar -src 文本数据文件 -region 地域csv文件 [-dst 生成的ip2region.db文件的目录]

3、代码实现及应用

下面给出使用ip2region.db解析IP地址的完整工具类定义代码：

public class AddressUtil {

public static String getCityInfo(int algorithm, String ip) {
try {
String dbPath = AddressUtil.class.getResource("/region/region.db").getPath();
File file = new File(dbPath);
if (!file.exists()) {
String tmpDir = System.getProperties().getProperty("java.io.tmpdir");
dbPath = tmpDir + "ip.db";
file = new File(dbPath);
FileUtil.writeFromStream(Objects.requireNonNull(AddressUtil.class.getClassLoader().getResourceAsStream("classpath:region/region.db")), file);
}
DbConfig config = new DbConfig();
DbSearcher searcher = new DbSearcher(config, file.getPath());
Method method;
switch (algorithm) {
case DbSearcher.BTREE_ALGORITHM:
method = searcher.getClass().getMethod("btreeSearch", String.class);
break;
case DbSearcher.BINARY_ALGORITHM:
method = searcher.getClass().getMethod("binarySearch", String.class);
break;
case DbSearcher.MEMORY_ALGORITYM:
method = searcher.getClass().getMethod("memorySearch", String.class);
break;
default:
method = searcher.getClass().getMethod("memorySearch", String.class);
break;
}
if (!Util.isIpAddress(ip)) {
log.error("错误的IP地址");
}
DataBlock dataBlock = (DataBlock) method.invoke(searcher, ip);
return dataBlock.getRegion();
} catch (Exception e) {
log.error("获取地址信息异常：{}", e.getMessage());
}
return "";
}
}

工具类AddressUtil方法getCityInfo给定一个IP，最终返回对应解析地址字符。

IP解析测试结果示例

总结

以上只是简单地以Java客户端作为应用举例，其他客户端及功能可去官网下载源码研究学习，当然如果同学们有更好的类似工具也欢迎分享交流。

项目地址：https://gitee.com/lionsoul/ip2region

感兴趣的同学，记得点赞[赞]并“关注”[握手]本头条哦。