笔记：纯真 IP 库使用

小乐笙2026-05-05 12:09

最近需要使用到ip解析成对应的地域，查找了一些资料，发现纯真ip库，这个比较好用，而且社区版可以获得免费授权。

纯真IP社区版是一款免费、公开且专注于IP地址定位的离线数据库。数据库采用全新的CZDB二进制格式，自2024年10月起，仅维护和更新该格式数据。它支持IPv4和IPv6地址查询，具备内存占用小、查询速度快、线程安全、更新便捷的特点。

部署与查询流程

第一步：获取官方授权

访问CZ88纯真IP库官网（https://www.cz88.net/），完成注册并登录账号；

第二步：下载并部署本地库

可通过以下命令下载对应版本库文件（示例链接，具体以官网实际链接为准）：

复制代码

# 下载IPv4社区版库
wget https://download.cz88.net/cz88_public_v4.czdb

# 下载IPv6社区版库（可选）
wget https://download.cz88.net/cz88_public_v6.czdb

第三步：Python快速查询示例（基于官方czipdb库）

复制代码

#!/usr/bin/env python3
from czipdb import CZIPDB

# 初始化数据库
ipdb = CZIPDB(
    db_file="cz88_public_v4.czdb",
    license_key="你的专属密钥"  # 替换为官网获取的密钥
)

# 测试查询
test_ips = ["114.114.114.114"]
for ip in test_ips:
    result = ipdb.query(ip)
    print(f"\nIP: {ip}")
    print(f"国家: {result.country}")
    print(f"省份: {result.province}")  # 示例输出：江苏/广东
    print(f"城市: {result.city}")      # 示例输出：南京/深圳
    print(f"运营商: {result.isp}")    # 示例输出：电信/联通