ip2region – 开源IP地址查询库,聚合IP地址库API

ip2region 开源IP地址查询库

ip2region 是一个准确率99.9%的ip地址库。 0.0x毫秒级查询,数据库文件大小只有1.5M,提供了java, php, c, python查询客户端和Binary,B树,内存三种查询算法。

1. 99.9%准确率,定时更新:

数据聚合了一些知名ip到地名查询提供商的数据,这些是他们官方的的准确率,经测试着实比纯真啥的准确多了。
每次聚合一下数据需要1-2天,会不定时更新。

ip2region的数据聚合自以下服务商的开放API或者数据(升级程序每秒请求次数2到4次): 

  1. >80%, 淘宝IP地址库:http://ip.taobao.com/ 
  2. ≈10%, GeoIP:https://geoip.com/ 
  3. ≈2%, 纯真IP库:http://www.cz88.net/ 

备注:如果上述开放API或者数据都不给开发时ip2region将停止数据的更新服务,目前是2~3个月更新一次。

2. 标准化的数据格式:

每条ip数据段都固定了格式:城市Id|国家|区域|省份|城市|ISP

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

3. 体积小:

生成的数据库文件ip2region.db只有1.5M(1.2版本前是3.5M)

4. 多查询客户端的支持,0.0x毫秒级别的查询

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

任何客户端b-tree都比binary算法快,当然Memory算法固然是最快的!

maven仓库地址:

nuget安装命令

5. 测试程序:

C#、Node.js、lua_c的测试请具体参考文件夹中README.md 说明。

java:

php:

c:

python:

lua:

均会看到如下界面:

输入ip地址开始测试,第一次会稍微有点慢,在运行命令后面接入binary,memory来尝试其他算法,建议使用b-tree算法,速度和并发需求的可以使用memory算法。

具体集成请参考不同客户端的测试源码。

6. 如何生成ip2region.db文件

从1.8版本开始,ip2region开源了ip2region.db生成程序的java实现,提供了ant编译支持,编译后会得到以下提到的dbMaker-{version}.jar,对于需要研究生成程序的或者更改自定义生成配置的请参考${ip2region_root}/maker/java内的java源码。

从ip2region 1.2.2版本开始里面提交了一个dbMaker-{version}.jar的可以执行jar文件,用它来完成这个工作:

  • 1, 确保你安装好了java环境(不玩Java的童鞋就自己谷歌找找拉,临时用一用,几分钟的事情)
  • 2, cd到${ip2region_root}/maker/java,然后运行如下命令:
  • 3, 获取生成的ip2region.db文件覆盖原来的ip2region.db文件即可
  • 4, 默认的ip2region.db文件生成命令:
ip2region - 开源IP地址查询库,聚合IP地址库API

7. 其他备注

  • 1, 全部binding的各个search接口都不是线程安全的实现,不同线程可以通过创建不同的查询对象来使用。
  • 2, memorySearch接口,在发布对象前进行一次预查询,可以安全用于多线程环境。