qqzeng-ip

module
v1.2.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 24, 2026 License: MIT

README

👑 qqzeng-ip / QZDB 极速 IP 地理位置解析引擎

English | 简体中文

Verification Latency Languages License

官方包已发布至各大平台,开箱即用 👇

Maven Central NuGet PyPI npm crates.io Packagist Go Module

QZDB (qqzeng IP Database) 是一款专为企业级高并发、云原生架构打造的下一代 IP 地理位置与号段归属地二进制搜索引擎。凭借双阶段 Patricia Trie 树算法、mmap 零拷贝以及无锁并发设计,单机支持 500 万+ QPS(C/Rust 原生可达 1000 万+ QPS,延迟低至纳秒级,多线程缓存扩展下吞吐可达数千万至亿级,口径与复现见 docs/PERFORMANCE.md)。


[!IMPORTANT] 🚀 为什么选择 QZDB 旗舰解析引擎?

  • ⚡ 极致性能:Rust / C / Go 基于只读内存映射(mmap)实现零堆分配查询,单次解析延迟低至 < 0.08 µs (80 纳秒)。
  • 🛡️ 全量无抽样验证:对全部 959,162 个 CIDR 区间的边界及中心 IP 进行了 2,877,486 次无抽样全量核对,通过率 100.00%。
  • 📦 高密存储:Trie 树前缀压路机算法,千万级全球 IP/CIDR 细化网段体积压缩率高达 95%+(仅十余兆)。
  • 🌐 全语言原生 SDK:官方提供 Rust, C/C++, Go, Java, C#, Node.js, PHP, Python 八种主流语言支持。

📑 目录 (Table of Contents)

章节 你会看到什么
⚡ 30 秒快速集成 8 语言一键安装命令 + Hello World 示例(新用户从这里开始)
🧭 核心产品线一键直达 IP / 号段 / 数据库 / 历史版本五大产品入口
📊 多语言 SDK 性能榜单 8 语言吞吐与延迟实测对比
📐 算法架构与查询流程 双阶段 Patricia Trie + Jump Table 原理
⚖️ 主流二进制格式对比 与 .mmdb / .xdb / .ipdb 的客观选型对比
📂 目录结构与数据规格 仓库结构、文件体积、五个版本字段定义
🗺️ 数据字段规范 大洲/国家/省市/经纬度/时区/运营商字段标准
🎯 典型应用场景 DNS 智能解析、CDN 调度、风控等落地场景
📱 手机号段归属库 50 万+ 号段 DAT 与 Redis 方案

🧭 核心产品线一键直达 (Product Navigation)

产品线 说明与核心亮点 包含内容 / 支持语言 快速入口
🚀 IP 旗舰 QZDB 解析 SDK 下一代旗舰:双阶段 Trie 树 + mmap 零分配,纳秒级检索,支持 IPv4/IPv6 全字段与风控 🦀 Rust · 🐹 Go · ☕ Java · ⚡ C/C++
🔷 C# · 🟩 Node · 🐍 Python · 🐘 PHP
👉 ip-qzdb-sdk/
📦 IP 经典版解析 SDK 经典在用:6.0 经典 .db 与 2.0 早期 .dat 格式多语言解析 SDK 与源码 v6.0 (.db) SDK · v2.0 (.dat) SDK 👉 ip-classic-sdk/
📱 手机号段归属地 SDK 50万+ 全号段:压缩率 95.7%+ 的二进制 DAT 解析及 Redis 高并发缓存方案 v2.0 ~ v6.0 DAT SDK · Redis 导入 👉 phone-location-sdk/
🗄️ 关系型数据库脚本 海量入库 DDL:针对 IP 网段与号段优化的建表、前缀索引与批量高速入库脚本 🐬 MySQL · 🐘 PostgreSQL · 🪟 SQL Server 👉 database-sql/
🗂️ IP 历史版本与工具 演进留档:IP 3.0~5.0 早期版本解析、Big DAT 与 Windows 离线查询工具 v3.0~v5.0 源码 · 桌面查询工具 👉 ip-history-sdk/
📋 脱敏测试样本数据 演示样例:IP 归属地与号段 CSV / TXT / QZDB 样例数据 全国/全球 IP 样例 · 号段样例 👉 demo/

💰 获取完整数据:仓库内为脱敏演示样本。五大版本(标准 ¥299 起 / 专业 ¥499 / ASN ¥399 / 旗舰 ¥699 / 至尊 ¥999),中国版/全球版可选;买断永久可用,包年更新每月 1 日自动推送(比单次更新省 40%+)。


📊 多语言 SDK 性能横向评测榜单 (SDK Benchmark)

分为两大工程阵营:原生/编译系统语言阵营(C、Go、Rust、Java、C#)注重高并发极致吞吐;动态脚本生态阵营(Node.js、PHP、Python)注重开箱即用与轻量集成。
测试数据均取自统一受控基准(Apple M4 Max 单线程,ip-qzdb-sdk/bench_reports/*.json 真实快照),数字由 CI 性能门禁守护。完整定义见下方折叠区与 docs/PERFORMANCE.md。

语言与阵营(点击直达源码) 单线程整型随机¹
口径 A · 真实契约基准
16 线程并发²
口径 B · 多核极限
字符串查询³
口径 C · 含 IP 解析
架构优化特点
👑 C / C++ 96.5 M/s 5.06 亿/s 12.6 M/s 极致轻量 · 零依赖 · 零拷贝 mmap
⚡ Go 97.3 M/s 7.19 亿/s 12.1 M/s 高并发 Goroutine · 单文件部署
🛡️ Rust (10月重构) 82.6 M/s 2.33 亿/s 11.5 M/s 值语义去共享化 · 4路组相联缓存
☕ Java 48.1 M/s (v4: 101M) 1.36 亿/s 11.9 M/s 堆外内存视图 · 全字段解析领先
🚀 C# 46.9 M/s 5.50 亿/s 20.9 M/s 原生内存映射 · 字符串全链路领先
───────── ───────── ───────── ───────── 动态脚本与应用生态阵营
🔥 Node.js 8.22 M/s (探针: 99M)⁴ 进程级多核 10.3 M/s BigInt 偏移解析 · JS 生态极速档
🐘 PHP 5.67 M/s (探针)⁴ FPM 进程池 470 K/s 纯 PHP 零扩展依赖 · 双模式缓冲
🐍 Python 1.30 M/s 多进程池扩展 273 K/s 零三方依赖 · 数据分析与快速接入
📐 口径定义、环境声明与复现方式(点开查看)
  • 口径 A|单线程整型随机(缓存最不利):整型输入、50 万离散散布 IP、省级 8.6MB 库、单线程 —— 容量规划的保守承诺值,编译语言单次寻址平均 10~25 ns;
  • 口径 B|16 线程并发:在只读 mmap 与不可变快照下,16 个工作线程并发压测的多核总吞吐;
  • 口径 C|字符串 find_str:字符串输入(含 IP 解析与格式校验)、demo 样本库 —— 与 CI 门禁同口径,跨语言可比;
  • ⁴ 契约基准与直测探针说明:统一契约包含伪随机流推进与防作弊指纹校验;Node.js 与 PHP 在契约下分别为 8.22M 与 0.72M,在消除流推进开销的极简裸循环探针下可达 99.4M 与 5.67M;
  • 环境与库规模效应:Apple M4 Max(14 核)单线程 best-of-3;x86 平台通常低 2~4 倍;122MB 全球库因超出 CPU L3 缓存容量,口径 A 约为省级库的 1/3(物理客观规律);
  • 完整定义与复现命令见 docs/PERFORMANCE.md。除 C/C++ 源码直编外,其余 7 语言均可由包管理器一条命令安装(见下方 Quick Start)。仅供技术选型参考,非 SLA。

⚡ 30 秒快速集成 (Quick Start)

无需克隆源码——QZDB SDK 已发布至各语言官方包仓库,一条命令即可接入。

📦 官方包一键安装
语言 包仓库 安装命令
🐍 Python PyPI pip install qzdb
🦀 Rust crates.io cargo add qzdb
🐹 Go Go Module go get github.com/zengzhan/qqzeng-ip/ip-qzdb-sdk/go
🔷 C# NuGet dotnet add package QQZeng.Qzdb
🟢 Node.js npm npm i @qqzengip/qzdb
🐘 PHP Packagist composer require qqzeng/qzdb
☕ Java Maven Central 见下方依赖片段
⚡ C / C++ 源码集成 下载 qzdb_reader.c + qzdb_reader.h 一起编译
☕ Java 的 Maven / Gradle 依赖片段

Maven:

<dependency>
    <groupId>com.qqzeng</groupId>
    <artifactId>qzdb</artifactId>
    <version>1.0.7</version>
</dependency>

Gradle:

implementation 'com.qqzeng:qzdb:1.0.7'
🚀 Hello World(8 语言)

八种语言的 API 设计保持一致:一次加载、长期持有实例、无锁并发查询。

🐍 Python
from qzdb import QzdbReader

searcher = QzdbReader("qqzeng_ip_ult_china.qzdb")

# 返回竖线分隔字符串
print(searcher.find_str("114.114.114.114"))
# 亚洲|CN|中国|江苏|南京|中国电信

# 返回结构化 GeoInfo
loc = searcher.find("114.114.114.114")
if loc:
    print(loc.country, loc.province, loc.city, loc.isp)
🦀 Rust
use qzdb::QzdbReader;

// from_file 走只读 mmap,返回 Result —— 请在启动期用 ? / match 处理
let searcher = QzdbReader::from_file("qqzeng_ip_ult_china.qzdb")?;

if let Some(loc) = searcher.find("114.114.114.114") {
    // 类型化字段访问(O(1),零分配)
    println!("Country: {}, City: {}", loc.country(), loc.city());
    // 动态字段访问
    println!("ISP: {}", loc.get("isp"));
}
🐹 Go
import (
    "fmt"
    "log"

    "github.com/zengzhan/qqzeng-ip/ip-qzdb-sdk/go/qzdb"
)

// 创建并持有 QzdbReader 实例(mmap 零拷贝,全局复用)
searcher, err := qzdb.Open("qqzeng_ip_ult_china.qzdb", 0, true)
if err != nil {
    log.Fatal(err)
}
defer searcher.Close()

// 返回竖线分隔字符串
fmt.Println(searcher.FindStr("114.114.114.114"))

// 返回结构化 GeoInfo
info, err := searcher.Find("114.114.114.114")
if err == nil && info != nil {
    fmt.Println(info.GetCountry(), info.GetProvince(), info.GetCity())
}
☕ Java
import com.qqzeng.qzdb.QzdbReader;
import com.qqzeng.qzdb.GeoInfo;

// Builder 模式,支持 groupIndex / verifyCrc
try (QzdbReader reader = new QzdbReader.Builder(new File("qqzeng_ip_ult_china.qzdb")).build()) {
    GeoInfo loc = reader.find("114.114.114.114").orElse(null);
    if (loc != null) {
        System.out.println(loc.getCountry() + " " + loc.getProvince() + " " + loc.getCity());
    }
    System.out.println(reader.findStr("114.114.114.114"));
}
🔷 C# (.NET)
using QQZeng.Qzdb;

using var reader = QzdbReader.Open("qqzeng_ip_ult_china.qzdb");
GeoInfo loc = reader.Find("114.114.114.114");
if (loc != null) {
    // 类型化取值
    Console.WriteLine("Province: " + loc.GetProvince());
    // 动态字段访问
    Console.WriteLine("ISP: " + loc.Get("isp"));
}
🟢 Node.js
const QzdbReader = require('@qqzengip/qzdb');

const reader = new QzdbReader.Builder("qqzeng_ip_ult_china.qzdb").build();
const loc = reader.find("114.114.114.114");
console.log(loc.get("country"), loc.get("city"));
🐘 PHP
require_once __DIR__ . '/vendor/autoload.php';
use Qqzeng\Ip\QzdbReader;

$reader = new QzdbReader("qqzeng_ip_ult_china.qzdb");
$loc = $reader->find("114.114.114.114");
echo $loc->get('country') . ' ' . $loc->get('city');
⚡ C / C++
#include "qzdb_reader.h"

qzdb_reader_t searcher;
qzdb_init(&searcher, "qqzeng_ip_ult_china.qzdb");   // 栈上持有实例
char buf[256];
qzdb_find_str(&searcher, "114.114.114.114", buf, sizeof(buf));
printf("Result: %s\n", buf);

更完整的 API 文档、错误处理与多语言用例,请参见 QZDB 多语言 SDK 指南。


📐 QZDB 算法架构与查询流程 (Algorithm Architecture)

QZDB 引擎核心采用专门定制的 双阶段 Patricia Trie 树型检索算法:

flowchart LR
    A["输入目标 IP (如 114.114.114.114)"] --> B["阶段1: Jump Table 前缀跳级 (16-bit 静态表定位)"]
    B --> C["阶段2: Patricia Trie LPM 匹配 (只读内存按位遍历)"]
    C --> D["阶段3: String Pool 物理偏移 (O1 无锁读取)"]
    D --> E["输出结果 (中国|江苏|南京|中国电信)"]
  1. 第一阶段 (Jump Table 快速跳级):
    • IPv4:默认预读 16-bit 的静态前缀跳转表($2^{16} = 65,536$ 个槽位)。根据 IP 的前两字节,直接 $\mathcal{O}(1)$ 跳转定位到 Trie 树的具体子树节点,消除前 16 层的递归遍历。
    • IPv6:根据数据量大小动态估算最佳跳转位数 v6_jump_bits(通常为 16~20 bit),同样实现首阶段的快速降维。
  2. 第二阶段 (Trie 节点匹配 & 字符串池偏移读取):
    • 在定位到的子树节点中,以最长前缀匹配 (LPM) 算法沿单侧节点向右/向左遍历。所有中间路由指针和叶子节点数据在文件中扁平化连续存放,极具 CPU 缓存友好性。
    • 查询命中后,SDK 会直接根据其物理偏移量(Offset)在预载入的只读字符串池(String Pool)中以 $\mathcal{O}(1)$ 解析最终文本,全程免去临界区上锁(Lock-free)。
维度指标 步数与物理特征 技术细节与架构机制
检索步数构成 16 位跳表一次直达 + Patricia 分叉节点行走 首阶段 $2^{16}$ 静态跳转表消除前 16 层递归,剩余位在压缩前缀树中仅沿实际分叉行走;最坏步数 $\le 16$ 步(v4)/ $\le 120$ 步(v6),步数与库内记录总数完全脱钩。
空间复杂度 极小量级(节点拓扑压缩) 经由前缀压路机算法压缩,每个 Trie 节点仅占用 6~8 字节,千万级全球 IP 树存储开销低于 20MB。
内存开销 (Memory) $\mathcal{O}(0)$ 零堆分配 原生编译型语言(Rust/C/Go)直接借助操作系统 mmap 进行零拷贝寻址与直读,无堆对象分配与 GC 停顿。

⚖️ 主流二进制 IP 数据格式对比 (Format Comparison)

为了帮助架构师进行客观技术选型,以下列出了 QZDB 与业界主流二进制 IP 格式在检索路径、记录形态与存储开销上的真实物理对比(详细基准报告见 docs/benchmark-comparison.md 与 docs/PERFORMANCE.md):

格式 检索路径(步数构成) 记录形态 体积驱动因素 客观短板
QZDB (qqzeng) 16 位跳表一次直达 + Patricia 分叉节点行走;步数与数据规模无关 字段级字典池 + 行间接层,记录存整数 ID,按偏移直读、无解码 索引与数据规模、字段池去重率 格式较新,生态以自家 8 语言官方 SDK 与持续一致性验证为中心
.mmdb (MaxMind) 逐位走搜索树,≤32 跳(v4)/ ≤128 跳(v6) 类型化 Map,可嵌套;值可指针去重,键名随记录重复编码 节点数 × 记录位宽 + 记录编码(含键名) 命中后需解码整条记录,解码与物化成本随字段数增长
.db (ip2region 旧版) 全库分段二分,约 $\log_2(\text{总段数})$ 步随机访存 单条拼接字符串 段数 × 索引条目 + 字符串总量 仅支持 IPv4;无字段结构划分(现行格式已升级为 xdb)
.xdb (现行版) 向量索引 $\mathcal{O}(1)$ 直达桶 + 桶内二分 $\mathcal{O}(\log M)$ 单条分隔符拼接字符串,整串级去重 512KB 固定向量索引 + 段数 × 14B(v4)+ 字符串总量 无字段级类型与字典,字段扩展需靠加长拼接字符串
.ipdb (IPIP) 逐位走二叉树,≤32 跳(v4)/ ≤128 跳(v6),节点 8B 定长 制表符拼接字符串,按元数据字段表定位 节点数 × 8B + 字符串总量 无字段级字典(相同字符串跨记录重复存);格式规范与生成工具链未公开
🔍 各格式核心机制深度说明(点开查看)
  • QZDB(双阶段压缩前缀树):首阶段 16-bit 静态跳转表一次直达子树,次阶段在 Patricia 树中仅沿实际分叉节点检索,最坏步数 $\le 16$ 步(v4),检索路径与全库规模完全脱钩;采用字段级独立字典池,网段记录存储整数 ID,SDK 按需直接通过 RowSchema 物理偏移直读目标字段,无需解码反序列化,亦无需 split 拆分字符串。
  • .mmdb(MaxMind 通用类型化嵌套树):二进制二叉树,逐位遍历(IPv4 ≤32 跳,IPv6 ≤128 跳)。虽然值支持指针去重,但键名随 Map 重复编码;命中后需递归反序列化整条记录,在高级语言中堆对象分配与物化开销随字段数量线性增长。
  • .db(ip2region 旧版,分段二分):构建期已将网段压平为互不重叠的起止范围,全库二分需约 $\log_2(\text{总段数})$ 步随机访存,对 CPU 缓存不友好;仅支持 IPv4,无字段类型划分。
  • .xdb(ip2region 现行版,分区向量索引):前两字节经 512KB 向量索引表 $\mathcal{O}(1)$ 直达对应桶,在桶内对 14B 定长段执行 $\mathcal{O}(\log M)$ 二分查找;载荷为纯字符串拼接,生成器支持整串级去重,但缺乏字段级类型与字典池,字段扩展需依赖拼接长字符串并在读取时做 split 拆分。
  • .ipdb(IPIP 专有前缀树):定长 8 字节节点的二叉树逐位遍历;记录区以制表符拼接字符串存储,缺乏字段级独立字典池(相同文本跨记录重复存储);官方 SDK 覆盖丰富,但格式规范与生成工具链未开源。

📂 核心产品与目录结构 (Project Structure)

目录/文件 说明 (Description)
ip-qzdb-sdk/ ⚡ QZDB 极速解析引擎——Rust / C / Go / Java / C# / Node.js / PHP / Python 八语言 SDK 全覆盖
ip-classic-sdk/ 📦 IP 数据库经典版 SDK——v6.0 (.db) 与 v2.0 (.dat) 经典在用解析源码
phone-location-sdk/ 📱 手机号段归属地 SDK——v2.0 至 v6.0 全版本多语言 DAT 解析 SDK 与 Redis 方案
database-sql/ 🗄️ 数据库建表与入库脚本——MySQL / PostgreSQL / SQL Server DDL 与高速导入脚本
ip-history-sdk/ 🗂️ IP 历史版本与工具归档——v3.0~v5.0 历史源码、Big DAT 与桌面离线查询工具
demo/ 📋 演示样本——IP 归属地与号段 CSV / TXT / QZDB 数据样例
docs/ 📄 项目文档与基准——架构设计、性能基准报告与维护指南
数据交付格式与产品规格 (Data Delivery Formats & Specifications)
格式分类 主要内容 文件大小 (以国内/全球版为例) 查询性能 适用场景
QZDB 二进制 (.qzdb) 包含 24-bit Trie 树索引、动态元数据与多语种压缩字符串池。 9.5 MB (国内版) / 160 MB (全球版) 内存映射读取,微秒级响应 高并发 Web 服务、防火墙网关、DNS 调度。支持 mmap 零拷贝加载。
CSV 文本 (.csv / .txt) 标准 CIDR 掩码文本,每行按大洲/国家/省/市/区/经纬度扁平展开。 11 MB (国内版) / 204 MB (全球版) 取决于底层数据库性能 离线数仓 ETL、报表分析。支持一键批量导入 MySQL, PostgreSQL, SQL Server。
IP 数据库产品划分与字段规格 (Database Editions & Fields)

依据项目官方权威规范(5 版本 × 2 区域 × 3 协议),本系列提供五个核心产品版本,各版本维度池及 CSV/QZDB 列字段定义如下:

版本 维度池数 核心定位 字段构成列表 (按规范排序顺序)
std 标准版 6 基础地理 + 运营商 continent, country_code, country, province, city, isp
pro 专业版 11 细粒度地理定位 std 字段 + district, geo_id, longitude, latitude, timezone
asn ASN 路由版 8 网络专项(无细粒度地理) continent, country_code, country, isp, asn, as_name, as_domain, usage_type
max 旗舰版 15 地理 + 路由 + 风控应用 pro 字段 + asn, as_name, as_domain, usage_type
ult 至尊版 25 全维度 (地理/英文/风控等) max 字段 + 10 个英文扩展项(continent_en, country_alpha3, country_en, province_en, city_en, district_en, languages, currency_code, phone_prefix, emoji_flag)

字段设计说明:

  • 规范物理排序:各版本在导出为 CSV 或构建 QZDB 时均遵循统一的「规范顺序」内插平铺(如英文扩展项 _en 紧随对应中文项,ASN 与应用场景位放置于末尾)。
  • 应用场景分类 usage_type:使用英文字符串存储网络应用场景分类值(如 Broadband、DataCenter、VPN、Cloud、Spider、Reserved 等),SDK 直接读取字符串无需位运算解码。
  • 老客户无缝迁移说明:旧版旗舰版(Ultimate 历史在售版为 11 维,仅地理无 ASN)的数据结构与当前的全新的 pro 专业版 (11 维) 完全一致,历史购入旗舰版的用户可直接无缝对应迁移至新版的 pro 专业版 ;全新版本的 max 旗舰版 则升级为 15 维(融入了网络 ASN 自治域与应用场景分类)。

🗺️ 数据多维层级与字段规范 (Data Dimensions & Schema)

QZDB 最新版支持动态字段拓扑(Schema),各版本通过标准的 CSV 扁平网段与 QZDB 二进制树提供一致的物理交付。典型多维字段定义如下:

字段类别 标准命名 数据格式示例 技术规范与参考标准
空间地理层 大洲 / 国家 / 省份 / 城市 / 区县 亚洲 / 中国 / 广东 / 深圳 / 南山 符合国家民政部 GB/T 2260 行政区划划分;国外细化至州/邦/郡/市级
英文与出境层 国家英文 / 国家二位代码 China / CN 符合国际标准化组织 ISO 3166-1 Alpha-2 规范
网络服务层 运营商 电信 / 联通 / 移动 / 阿里云 / AWS 支持全球主流 ISP 节点与各大主流云服务商 IDC 网段标记
位置投影层 经纬度 113.930478,22.53332 基于 WGS-84 坐标系,提供高精度十进制经纬度
时间与时区层 时区 Asia/Shanghai 符合 IANA Time Zone Database (TZDB) 标准时区名称
行政属性层 区域代码 440305 中国六位标准行政代码(地方识别码与行政区划代码)

🎯 典型应用场景与用途 (Application Scenarios)

1. DNS 智能解析
  • 国内运营商线路:支持按电信、联通、移动、教育网、鹏博士、广电网等智能解析,细分到省份。
  • 海外地区线路:细分到大洲、国家。
  • 自定义控制策略:基于 IPTables 的高级访问控制 (ACL),设置 Allow from / Deny from 规则。
  • 多维度网络接入:支持识别阿里云、腾讯云、华为云、亚马逊/Amazon、微软/Microsoft、谷歌/Google 等主流云服务商网段。
2. 核心业务用途
  • 内容分发与 CDN 差异化:基于用户地理位置采用差异化内容分发策略,保障就近访问以提升用户访问体验。
  • 精准定点投放:依赖高精度地理位置数据库实现区域化精准定点投放,提高触达率并优化运营成本。
  • 智能网络流量调度:在高效流量调度、智能 DNS 服务、网络服务质量监测等环节起到基础支撑作用。
  • 统计分析与行为决策:多维度分析区域流量数据,研判不同地域的用户访问行为,为制定网络策略提供决策依据。
  • 多领域业务安全防护:广泛应用于地理位置识别、安全防护、网络管理、内容分发、电子商务等各领域企业。

📱 手机号段归属地数据库 (Phone Location Database)

50万+ 手机号段(前7位):包含归属地省市区、邮编、区号、行政代码与运营商,提供极致压缩的 .dat 二进制解析 SDK 与 Redis 缓存支持。详细源码请见 phone-location-sdk/。

字段信息:广东|深圳|518000|0755|440300|中国移动
编码:UTF-8    字节序:Little-Endian
存储与压缩效果 (Storage & Compression)
版本 文件格式 文件体积 压缩率 查询时间复杂度 核心技术特征
原始数据 .txt / .csv ~30 MB — — 原始纯文本明文
v6.0 (最新版) .dat / .db 1.28 MB ▸ 95.7% $\mathcal{O}(1)$ 超高并发微秒级响应,空间极致压缩
v5.0 .dat 1.60 MB ▸ 94.6% $\mathcal{O}(1)$ 扁平化数据块,高并发无锁检索
v4.0 .dat 1.80 MB ▸ 94.0% $\mathcal{O}(\log N)$ 区间二分索引结构
v3.0 .dat 1.95 MB ▸ 93.5% $\mathcal{O}(\log N)$ 基础二分查找,低内存占用
v2.0 .dat 2.40 MB ▸ 92.0% $\mathcal{O}(\log N)$ 早期经典二进制解析格式

Image text

🌟 未来展望

qqzeng-ip 持续专注于高性能地理位置与号段解析引擎的打磨,以提供更准确、更精细、极低延迟的数据基础设施产品。

Image text

Directories

Path Synopsis
ip-classic-sdk
ip-history-sdk
3.1/go
Package qqzengip 提供高性能 IP 地址查询功能 使用前缀索引 + 二分查找算法,单次查询延迟 < 20ns 支持并发安全,适用于亿级 QPS 场景
Package qqzengip 提供高性能 IP 地址查询功能 使用前缀索引 + 二分查找算法,单次查询延迟 < 20ns 支持并发安全,适用于亿级 QPS 场景
ip-qzdb-sdk
go module

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL