⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 github.com/zoujingli/ip2region 「zoujingli」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注**微信公众号：【芋道源码】**有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

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

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

功能特性

查询准确率高达99.9%

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

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

文件体积小

数据库文件 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。

快捷安装

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

快速测试

请参考每个 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@gmail.com  |  
| Type 'quit' to exit program      |  
+----------------------------------+  
p2region>> 101.105.35.57  
2163|中国|华南|广东省|深圳市|鹏博士 in 0.02295 millseconds

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

开源地址：

https://github.com/zoujingli/ip2region

芋道源码 —— 纯源码解析博客

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