# qqzeng-ip **Repository Path**: bbat/qqzeng-ip ## Basic Information - **Project Name**: qqzeng-ip - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-11 - **Last Updated**: 2026-05-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # qqzeng-ip 项目文档 ## 🚀 最新版本 6.0 (Recommended) > **[进入 6.0 多语言极速解析 SDK 文档](./6.0/README.md)** **qqzeng-ip 6.0** 代表了 IP 解析技术的较高标准。 - **极致性能**：Rust/Go/C# 版本均突破 **4000万 QPS**。 - **全语言支持**：C, Rust, Go, Java, Node.js, C#, Python, PHP。 - **工业级品质**：无锁设计、线程安全、零依赖、100% 单元测试覆盖。 | 排名 | 语言 | 版本 | QPS (查询/秒) | 耗时 (300w次) | 性能评价 | 状态 | |:---|:---|:---|:---|:---|:---|:---| | 1 | **Rust** | 1.90.0 | **55,065,026** | 54.48ms | 🛡️ **极速安全** | ✅ **完美** | | 2 | **Go** | 1.24.3 | **43,150,826** | 69.52ms | ⚡ **高速** | ✅ **卓越** | | 3 | **C#** | .NET 10.0 | **42,285,861** | 70.00ms | 🚀 **惊艳** | ✅ **优秀** | | 3 | **Node.js**| 25.2.1 | **40,962,924** | 73.24ms | 🔥 **惊艳** | ✅ **优秀** | | 5 | **C** | Clang 17.0 | **39,012,744** | 76.90ms | 👑 **王者** | ✅ **优秀** | | 6 | **Java** | 21.0.9 | **28,042,469** | 142.00ms | ☕ **稳健** | ✅ **良好** | | 7 | **PHP** | 8.5.1 | **1,013,356** | 3.95s | 🐘 **实用** | ✅ **可用** | | 8 | **Python** | 3.14.0 | **235,800** | 16.96s | 🐢 **标准** | ✅ **标准** | --- ## 项目简介 **qqzeng-ip** 是一个高性能的IP地址数据库解析工具，专注于快速查询全球IP地址的归属地信息。支持多语言开发与灵活的数据格式，适用于多种场景。 --- ## 新版格式 CIDR 数据库：cidr，地区信息，运营商信息，等多维结构 二进制：文件小，高效率，多种语言解析查询 .db ## CIDR vs IP Range - **简化表示**： 使用“IP 地址/前缀长度”（如 `192.168.1.0/24`），比传统起止 IP 范围更简洁。 单个 IP 地址仍保留为单一值（不需要添加后缀 /32 或 /128） - **无缝集成**： 现代网络工具、防火墙和数据库直接支持 CIDR，降低配置复杂性。 - **简化计算**： 地址总数和子网划分计算更直观高效。 - **提高准确性**： 前缀追踪减少 IP 分配重叠和错误。 - **降低复杂性**： 单列替代多列设计，查询和管理更简单。 - **面向未来**： 原生支持 CIDR 数据类型，确保长期兼容性，IPv4和IPv6。 ## 核心内容 ### 1. 数据库版本与格式 | **分类** | **描述** | |--------------------|--------------------------------------------------------------------------| | **全球旗舰版** | 覆盖国内外IP，含港澳台及240+国家/地区的省市区、运营商、经纬度信息。 | | **国内精华版** | 聚焦中国内地及港澳台的省市区、运营商信息。 | | **国外拓展版** | 细化国外240+国家/地区，大部分城市、运营商 数据。 | | **CIDR掩码版** | 支持路由协议等场景的掩码分组优化格式。 | --- ## 📂 目录结构备注 (Project Structure) | 目录/文件 | 备注 (Description) | | :--- | :--- | | **`6.0/`** | **最新版本**：包含 Rust/Go/C#/Node.js/C/PHP 等多语言极速解析 SDK | | **`archive/`** | **历史归档**：存放旧版本（如 2.0, 3.0）的代码和数据文件 | | **`docs/`** | **文档中心**：详细的开发文档和使用说明 | | **`qqzeng-ip-php/`** | **PHP版**：高性能内存驻留解析实现（优化版） | | **`qqzeng-ip-go/`** | **Go版**：高并发支持，适用于云原生场景 | | **`qqzeng-ip-rust/`** | **Rust版**：极致性能与安全 | | **`qqzeng-ip-python/`** | **Python版**：简洁易用，适合数据分析 | | **`mysql/`, `mssql/`, `pgsql/`** | **数据库脚本**：用于将 IP 数据导入对应数据库的 SQL 脚本 | | **`qqzeng-phone-x.0/`** | **手机号段归属地**：不同版本的手机号段解析工具（2.0 - 6.0） | | **`demo-data/`** | **示例数据**：用于测试和演示的样本数据 | | **`qqzeng-ip-dat/`** | **DAT格式**：二进制紧凑格式说明 | | **`qqzeng-ip-txt/`** | **TXT格式**：文本格式说明与示例 | | **数据格式** | **特点** | |--------------------|--------------------------------------------------------------------------| | DAT格式 | 文件小（10几M），查询性能达纳微秒级解析。 | | TXT格式 | 一两百M，支持导入MySQL/MSSQL，便于灵活扩展处理。 | #### [3.0 版本 (历史归档)](https://github.com/zengzhan/qqzeng-ip/tree/master/archive/3.0) > ⚠️ **停止更新公告**： > 3.0 版本曾以极致的压缩率和千万级 QPS 性能著称。但由于全球 IP 数据库规模持续增长，原有数据结构于 **2016年1月** 达到容量上限。 > > **请务必升级至 [6.0 最新版](./6.0/README.md)**：6.0 版本采用了全新的数据结构，打破了容量限制，同时保持了纳秒级的查询性能。 --- ### 2. 数据维度与覆盖 - **字段信息** 大洲、国家（中英文）、省份、城市、县区、运营商、行政代码、经纬度等。 ### 数据质量 - **精准度** - 中国省份 >99.9% / 城市 >97.8% - **覆盖度** - 全球范围：241个国家和地区（含中国全量城市） - 行政细化：上万个国外州/邦/省/郡/道级行政区 - 网络覆盖：电信、联通、移动、阿里云、腾讯云、华为云、百度云等几千个国内外服务商。 - 国内线路：电信/联通/移动铁通·教育网·广电等2000+运营商 - 国际网络：覆盖5000+海外服务商 --- ### 4. 多语言与扩展支持 - **开发语言** C/C++、Java、C#、Python、Go、Rust、NodeJs、Php 等十余种语言。 - **数据库集成** MySQL/MSSQL/PgSQL/Redis 脚本支持，批量导入与查询。 --- ### 5. 应用场景 （1）IP智能切换城市，用户智能跳转到用户所在城市内容模块。 （2）根据ip区域化为不同区域提供内容个性化，实现差异化策略。 （3）区域化精准的广告投放，根据客户群定制广告，依赖于IP地址库的准确性。 （4）高效流量调度、智能DNS服务、 网络服务质量监测等方面起到重要的作用。 （5）流量统计分析，了解访问效果和用户行为，为进一步修正或重新制定网络营销策略提供依据。 （6）精确的定位数据可以帮助定位用户精确位置、分析区域数据、判断不同地域用户人群的行为习惯、为用户提供个性化的服务、精确定点投放业务广告，实现准确操作，提升用户体验，节约运营成本 客户已经涉及很多领域，包括 电子商务、门户、杀毒、网游、广告、旅游、流量分析、站点供应商及各领域公司和企业 #### 智能应用 - 󠀠󠀠**精准分发**：基于地理围栏的差异化内容/优惠策略 - 󠀠󠀠**广告优化**：区域定点投放降低30%+运营成本（依托高精度库） - 󠀠󠀠**网络治理**：智能DNS·流量调度·服务质量监测体系 - 󠀠󠀠**数据洞察**：地域流量画像支撑网络营销策略 #### 行业服务 - **核心领域**：地理识别·网络安全·CDN·电商 - **扩展场景**：政务监管·旅游定位·物流调度·IoT设备管理 --- # IP Search Performance Tests 🧪 > **最新测试结果请查看 [6.0 性能评测](./6.0/README.md#%E6%80%A7%E8%83%BD%E8%AF%84%E6%B5%8B-%E6%9C%80%E6%96%B0%E6%B5%8B%E8%AF%95)** ## 历史版本对比 (随机亿级测试) | 方法 | 总次 | 时间 | 每秒 (QPS) | 提升倍数 | |----------------------|--------------|---------|----------|---| | qqzeng-ip-search-2.0 | 1.64亿 | 17.29秒 | 948万 | 1x | | qqzeng-ip-search-3.0 | 1.70亿 | 10.95秒 | 1553万 | ~1.6x | | **qqzeng-ip-search-6.0** | **1.75亿** | **5.68秒** | **3080万** | **~3.2x** | *(注：6.0 版本在 Rust/Go 等语言实现中已突破 5000万 QPS，详见 6.0 文档)* ## 手机号段归属地-多语言解析以及导入数据库脚本 qqzeng-phone-6.0.dat [6.0版本](https://github.com/zengzhan/qqzeng-ip/tree/master/qqzeng-phone-6.0) 字段信息： 广东|深圳|518000|0755|440300|移动 编码：UTF8 字节序：Little-Endian ### 存储与性能 #### 🗜️ 极致压缩 | **版本** | **格式** | **体积** | **压缩率** | |----------|----------|----------|-------------| | 原始数据 | TXT | 30 MB | - | | v6.0 | DAT | 1.28 MB | ▸ 95.7% | | v3.0 | DAT | 1.95 MB | ▸ 93.5% | | v2.0 | DAT | 2.40 MB | ▸ 92.0% | #### ⚡ 性能突破 - **解析速度**：超5,000万次/秒（较传统方案快200%） - **资源占用**：内存消耗<10MB，适配高并发场景 - **架构优势**：二进制DAT格式实现近O(1)时间复杂度查询 ### 号段归属地查询性能对比（2.0-6.0版本） #### 测试环境 - **硬件**：Apple M4 Max，14核 CPU - **操作系统**：macOS x64 - **年份**：2025 #### 时间复杂度 - **范围**：O(log n) 到 O(1) #### 性能数据 #### 版本 2.0 (qqzeng-phone-2.0.dat) | 查询次数（万） | 时间（秒） | 每秒查询次数（万次） | |----------------|------------|-------------------------------| | 8932 | 6.682 | 1336.7255312780603 | | 11310 | 8.235 | 1373.4061930783243 | | 11136 | 8.24 | 1351.4563106796115 | | 8526 | 6.176 | 1380.5051813471503 | | 10962 | 7.917 | 1384.6153846153848 | | 11020 | 7.947 | 1386.6868000503334 | | 7192 | 5.17 | 1391.10251450677 | **平均每秒查询次数**：约 1380.79 万次 --- #### 版本 3.0 (qqzeng-phone-3.0.dat) | 查询次数（万） | 时间（秒） | 每秒查询次数（万次） | |----------------|------------|-------------------------------| | 8236 | 2.824 | 2916.43059490085 | | 9280 | 3.129 | 2965.803771172899 | | 6902 | 2.315 | 2981.4254859611233 | | 7424 | 2.565 | 2894.346978557505 | | 11426 | 3.931 | 2906.6395319257185 | | 6496 | 2.251 | 2885.8285206574856 | | 11252 | 3.849 | 2923.3567160301377 | **平均每秒查询次数**：约 2924.97 万次 --- #### 版本 4.0 (qqzeng-phone-4.0.dat) | 查询次数（万） | 时间（秒） | 每秒查询次数（万次） | |----------------|------------|-------------------------------| | 7308 | 1.201 | 6084.929225645295 | | 5800 | 0.954 | 6079.664570230609 | | 7308 | 1.186 | 6161.888701517707 | | 8352 | 1.328 | 6289.156626506024 | | 9860 | 1.582 | 6232.616940581542 | | 9802 | 1.57 | 6243.312101910828 | | 7018 | 1.14 | 6156.140350877194 | **平均每秒查询次数**：约 6178.24 万次 --- #### 版本 5.0 (qqzeng-phone-5.0.dat) | 查询次数（万） | 时间（秒） | 每秒查询次数（万次） | |----------------|------------|-------------------------------| | 7888 | 0.376 | 20978.723404255317 | | 11136 | 0.529 | 21051.039697542532 | | 6322 | 0.296 | 21358.10810810811 | | 7366 | 0.346 | 21289.017341040464 | | 9512 | 0.449 | 21184.855233853006 | | 8410 | 0.395 | 21291.139240506327 | | 6728 | 0.313 | 21495.20766773163 | **平均每秒查询次数**：约 21235.44 万次 --- #### 版本 6.0 (qqzeng-phone-6.0.db) | 查询次数（万） | 时间（秒） | 每秒查询次数（万次） | |----------------|------------|-------------------------------| | 6786 | 0.409 | 16591.687041564794 | | 9106 | 0.544 | 16738.970588235294 | | 8700 | 0.522 | 16666.666666666664 | | 6844 | 0.41 | 16692.682926829268 | | 9164 | 0.55 | 16661.81818181818 | | 6496 | 0.385 | 16872.727272727272 | | 9512 | 0.571 | 16658.493870402803 | **平均每秒查询次数**：约 16683.29 万次 --- #### 观察结果 - **版本 5.0** 性能最佳，平均每秒查询约 21235.44 万次，远超其他版本。 - **版本 4.0** 相较 2.0 和 3.0 有显著提升，平均每秒查询约 6178.24 万次。 - **版本 6.0** 性能略低于 5.0，平均每秒查询约 16683.29 万次，但仍高效。 - 性能提升与数据结构或算法优化相关，后期版本的查询时间接近 **O(1)**。 --- ![Image text](https://github.com/zengzhan/qqzeng-ip/blob/master/archive/qqzeng-ip-%E6%9F%A5%E8%AF%A2%E5%B7%A5%E5%85%B7/qqzeng-ip-trace-2026.webp) 演示  https://www.qqzeng.com/ip 统计 https://www.qqzeng.com/tongji.html 官网 https://www.qqzeng.com # 未来 **qqzeng-ip** 我们持续更新和完善数据库，以提供更加准确和精细，高性能的产品。 ![Image text](https://www.qqzeng-ip.com/res/github-qrcode.png)