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

一、简介

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毫秒级别,内置了三种查询算法

  1. memory算法:整个数据库全部载入内存,单次查询都在0.1x毫秒内,C语言的客户端单次查询在0.00x毫秒级别。
  2. binary算法:基于二分查找,基于ip2region.db文件,不需要载入内存,单次查询在0.x毫秒级别。
  3. 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。解析IP知多少?推荐一款超好用的开源IP解析工具IP2Region

各客户端查询性能数据(注:图片数据来源于官网)

(说明:数据及描述来源于官网)

三、应用

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文件作为资源文件添加到项目中,如下图所示:解析IP知多少?推荐一款超好用的开源IP解析工具IP2Region

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知多少?推荐一款超好用的开源IP解析工具IP2Region

IP解析测试结果示例

总结

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

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

内容出处:,

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

发表评论

登录后才能评论