IP地址库的维护者们迎来了一次关键升级。ip2region,这款以高性能、离线运行为核心优势的开源IP地理定位框架,现已正式发布3.13.0版本。它的核心亮点非常清晰:全面支持IPv4与IPv6,能够轻松处理亿级IP段数据,单次查询响应时间稳定控制在10微秒以内。更值得一提的是,该框架为多种主流编程语言提供了现成的xdb格式数据生成器与查询SDK,极大降低了开发者的集成门槛。
先来看看社区生态的新进展。ip2region官方社区已正式上线,目标非常明确——构建更加完善的IP工具生态和综合数据服务体系。目前,已商用的离线数据库、在线查询体验平台,以及完整的xdb使用指南和技术文档,都已陆续在社区中落地。
那么,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 Ja va|Semarang|PT Telekomunikasi Indonesia|ID222.124.252.0|222.124.252.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规范。实际查询返回结果示例如下:
➜ 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。 - 各语言绑定仓库中的README示例查询结果均已同步更新至最新版数据,确保文档内容与实际输出完全保持一致。详情见PR/429。
本次更新的数据已同步推送至GitHub和Gitee官方仓库,xdb二进制文件也已完成重新编译。用户只需下载最新版xdb文件并覆盖旧文件即可完成升级。需要特别提醒:国家ISO Alpha-2代码位于字段第5位(下标4,从0开始计数),使用时请注意索引位置。
源码获取地址:点击下载
