一、简介

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

内容出处：，

声明：本网站所收集的部分公开资料来源于互联网，转载的目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。如果您发现网站上有侵犯您的知识产权的作品，请与我们取得联系，我们会及时修改或删除。文章链接：http://www.yixao.com/share/26383.html

IP2Region：一款超好用的开源IP解析工具

一、简介

二、优势

三、应用

总结

相关推荐

发表评论