
ip2region 是一款高性能、离线运行的 IP 地址管理与地理定位开源框架,全面兼容 IPv4 与 IPv6 协议,可高效处理上亿级 IP 段数据,单次查询响应时间稳定在 10 微秒以内,并为多种主流编程语言提供了 xdb 格式的数据生成器与查询 SDK。
ip2region 官方社区现已正式启用,致力于构建更完善的 IP 工具生态与数据服务体系,当前已上线商用级离线数据库、在线查询体验平台,以及完整的 xdb 使用指南与技术文档。
ip2region 3.13.0 版本核心更新内容如下:
统一规范中国大陆特殊行政区划名称为全称:如“香港”更新为“香港特别行政区”,“澳门”更新为“澳门特别行政区”等,具体变更见 [PR/423]。
根据用户反馈优化部分国内 IPv4 / IPv6 地址段的归属信息,提升定位准确性,详见 [PR/424]。
对全部海外 IPv4 与 IPv6 地址段的地理信息进行系统性校准与更新,所有境外数据统一采用英文描述,境内数据仍保留中文;国家名称严格遵循
ISO-3166国际标准。相关调整请参阅 [PR/427] 与 [PR/428]。示例数据如下:
222.124.251.0|222.124.251.255|Indonesia|Central Java|Semarang|PT Telekomunikasi Indonesia|ID222.124.252.0|222.124.255.255|Indonesia|Riau|Batam|PT Telekomunikasi Indonesia|ID222.125.0.0|222.125.255.255|中国|广东省|深圳市|深圳市天威视讯|CN222.126.0.0|222.126.116.95|Philippines|Metro Manila|Makati City|0|PH222.126.116.96|222.126.127.255|Philippines|Metro Manila|Manila|0|PH222.126.128.0|222.126.159.247|中国|广东省|深圳市|亚太环通|CN
- 在 IPv4 与 IPv6 全量数据中新增
iso-3166-alpha2-code(国家两位字母代码)字段,整体格式统一为:国家|省份|城市|ISP|iso-3166-alpha2-code。其中,“科索沃”未被 ISO 官方分配标准 alpha2 编码,故暂用非官方临时代码XK;其余所有国家代码均严格符合 ISO-3166 规范。详情请查阅 [PR/427] 和 [PR/428]。实际查询返回结果示例如下:
➜ golang git:(master) ./xdb_searcher searchip2region search service test program+-v4 db: /data01/code/c/ip2region/data/ip2region_v4.xdb (vectorIndex)+-v6 db: /data01/code/c/ip2region/data/ip2region_v6.xdb (vectorIndex)type 'quit' to exitip2region>> 1.2.3.4{region: Australia|Queensland|Brisbane|0|AU, took: 4.216552ms}ip2region>> 113.118.113.77{region: 中国|广东省|深圳市|电信|CN, took: 3.253902ms}ip2region>> 240e:3b7:3273:51d0:ebae:761:a5e3:bc69 {region: 中国|广东省|深圳市|电信|CN, took: 3.693716ms}ip2region>> 2604:a840:3::a04d{region: United States|California|San Jose|xTom|US, took: 4.70235ms}ip2region>>
所有保留地址段(Reserved IP Range)的定位信息标准化为固定值:
Reserved|Reserved|Reserved|0|0,详见 [PR/430]。各语言绑定(binding)仓库中的 README 示例查询结果均已同步更新至最新版数据,确保文档与实际输出一致,详见 [PR/429]。
本次更新数据已同步至 GitHub 与 Gitee 官方仓库,xdb 二进制文件也已完成重新编译。用户只需下载最新版 xdb 文件并覆盖旧文件即可完成升级。国家 ISO Alpha-2 代码可通过字段第 5 位(即下标 4,从 0 开始计数)获取。
源码获取地址:点击下载










