大家好，我是 JavaPub。

在工作中我们常会遇到 IP 信息解析的情况，而商用的 IP 解析都是按调用次数收费，对于很多小公司和个人也是一笔不小的开支💰。这里推荐一个离线 IP 库，可以满足大多数开发场景。

-

正文

Ip2region 是一个离线 IP 地址定位库，准确率高达 99.9%，搜索性能为 0.0x 毫秒。DB 文件只有几兆字节，其中存储了所有 IP 地址。


支持 Java、PHP、C、Python、Nodejs、Golang、C#、lua 等查询绑定。查询算法使用二叉树、B树和内存搜索算法。

 

1

功能特性


查询准确率高达99.9%


数据来源于一些知名的 IP 查询提供商，经测试比纯 IP 定位更准确一些。



文件体积小


数据库文件 ip2region.db 只有几 MB 大小，最小的版本不超过 1.5MB，最大的不超过 8MB。


标准数据格式


每条 ip 数据段都固定了格式，目前只有国内的数据可以精确到城市级别，其他国家只有部分可以定位到国家，其余无法确认的数据默认值为 0 。


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


查询速度快


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


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


多种查询客户端的支持


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


2

快捷安装


maven仓库地址


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


nodejs


npm install node-ip2region --save


nuget安装


Install-Package IP2Region


php composer


composer require zoujingli/ip2region


3

快速测试


请参考每个 binding 下的 README 说明去运行 cli 测试程序，例如 C 语言的 demo 运行如下：


cd binding/c/  
gcc -g -O2 testSearcher.c ip2region.c
./a.out ../../data/ip2region.db


会看到如下 cli 界面：


initializing B-tree ...
+----------------------------------+
| ip2region test script |  
| Author: chenxin619315@ |  
| Type 'quit' to exit program |  
+----------------------------------+
p2region>> 101.105.35.57  
2163|中国|华南|广东省|深圳市|鹏博士 in 0.02295 millseconds


输入 IP 地址开始测试，第一次会稍微有点慢，在运行命令后面接入 binary、memory 来尝试其他算法，建议使用 b-tree 算法，速度和并发需求的可以使用memory 算法，具体集成请参考不同 binding 下的测试源码。


开源地址：https:///zoujingli/ip2region

硬核推荐

文章底部都有对应原创PDF，持续更新中， 教程纯手打，致力于最实用教程，微信搜：JavaPub ，无套路领取免费原创 PDF 、学习路线图，后台回复【666】。



准确率 99.9% 的离线IP地址定位库_php