ip2region 3.13.0 发布 开源数据更新 中英双语 ISO国家代号

IP地址库的维护者们迎来了一次关键升级。ip2region，这款以高性能、离线运行为核心优势的开源IP地理定位框架，现已正式发布3.13.0版本。它的核心亮点非常清晰：全面支持IPv4与IPv6，能够轻松处理亿级IP段数据，单次查询响应时间稳定控制在10微秒以内。更值得一提的是，该框架为多种主流编程语言提供了现成的xdb格式数据生成器与查询SDK，极大降低了开发者的集成门槛。

先来看看社区生态的新进展。ip2region官方社区已正式上线，目标非常明确——构建更加完善的IP工具生态和综合数据服务体系。目前，已商用的离线数据库、在线查询体验平台，以及完整的xdb使用指南和技术文档，都已陆续在社区中落地。

那么，3.13.0版本具体带来了哪些实质性变化？

核心更新内容如下：

1. 中国大陆特殊行政区划名称进行了统一规范化处理。例如，“香港”调整为“香港特别行政区”，“澳门”调整为“澳门特别行政区”。具体改动细节可参考PR/423。

2. 基于用户真实反馈，对部分国内IPv4/IPv6地址段的归属信息进行了针对性优化，定位准确度进一步提升。详情见PR/424。

3. 这是一次全球范围内的数据校准——所有海外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

4. 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>>

5. 所有保留地址段（Reserved IP Range）的定位信息被标准化为固定值：Reserved|Reserved|Reserved|0|0。具体调整详见PR/430。
6. 各语言绑定仓库中的README示例查询结果均已同步更新至最新版数据，确保文档内容与实际输出完全保持一致。详情见PR/429。

本次更新的数据已同步推送至GitHub和Gitee官方仓库，xdb二进制文件也已完成重新编译。用户只需下载最新版xdb文件并覆盖旧文件即可完成升级。需要特别提醒：国家ISO Alpha-2代码位于字段第5位（下标4，从0开始计数），使用时请注意索引位置。

源码获取地址：点击下载