如何通过IP地址查实际地址?
一、重要说明
纯真社区的朋友:
免费和公开，是纯真社区版IP库创始第一天就带有的基因。纯真将继续为大家提供免费的纯真社区版IP库：
- DAT格式（计划于10月1日起停止维护，目前已经停止在微信公众号上发布下载地址，最新7月10日发布版本请大家前往官网下载）
- EXE格式（计划于10月1日起停止维护，目前已经停止在微信公众号上发布下载地址，最新7月10日发布版本请大家前往官网下载）
- CZDB格式（正式发布支持IPv4和IPv6地理位置的全新CZDB数据格式，并计划从2024年10月开始只维护更新该格式的数据）
CZDB目前已支持JAVA和C语言解析程：
- JAVA解析程序 https://github.com/tagphi/czdb-search-java
- C语言解析程序 https://github.com/tagphi/czdb-search-c
- PHP语言解析程序 https://github.com/tagphi/czdb-search-c
后续免费获取纯真社区版IP库的方式纯真社区版IP库根据知识共享署名-相同方式共享 4.0 国际许可证（BY-SA 4.0 DEED）公开发布。如您需要使用纯真社区版IP库，您可在使用该数据的网站、应用程序或社交媒体帐户上显示纯真网站信息，以此获得该IP库的使用授权以及后续的更新下载服务。您可以按照如下步骤指引来获取后续持久的纯真社区版IP库更新下载权限：
第一步，在纯真官网(https://www.cz88.com)上注册并登录。
第二步，在纯真社区版IP库介绍页面上(https://www.cz88.com/geo-public)，任意选取一种方式对纯真社区版IP库进行宣传。您可选择在您使用纯真社区版IP库的相关页面上对纯真网址进行展示，或者选择在中文专业论坛上分享关于纯真社区版IP库的使用体会（可参考我们提供的默认文本，也强烈建议自行发挥撰写有关纯真的内容以免被删贴）。
第三步，在页面上提供截图资料供我们审核。
二、使用
CZDB Searcher
CZDB Searcher 是一个用于高效 IP 地理位置查询的 Python 库，它使用紧凑的数据库格式和二叉树搜索算法，提供快速准确的 IP 查找功能。
特点
- IP 地理位置查询
- 支持 IPv4 和 IPv6 地址
- 简单易用的 API
性能
请尽量使用单例来查询，避免每次查询都初始化DbSearcher，这会带来性能瓶颈。同时要注意BTREE模式查询时不是线程安全的。
安装
在项目目录下运行以下命令来安装 CZDB Searcher 所需的第三方库：
pip install msgpack
pip install pycryptodome
使用方法
以下是一个快速开始的示例：
import sys
from czdb.db_searcher import DbSearcher
database_path = "/path/to/your/database.czdb"
query_type = "BTREE"
key = "YourEncryptionKey"
ip = "8.8.8.8"
db_searcher = DbSearcher(database_path, query_type, key)
try:
region = db_searcher.search(ip)
print("搜索结果：")
print(region)
except Exception as e:
print(f"An error occurred during the search: {e}")
db_searcher.close()
请将 database_path 和 key 替换为您项目中实际的数据库路径和加密密钥。
配置
DbSearcher 构造函数接受以下参数：
databasePath：您的 CZDB 数据库文件路径。searchMode：搜索模式（例如，"BTREE" 或者 "MEMORY"）。encryptionKey：密钥。
数据库文件和密钥可以从 www.cz88.net 获取。
模式选择
- 批量查询：对于批量查询，建议使用 "MEMORY" 模式。这是因为 "MEMORY" 模式会将数据库加载到内存中，从而提高查询速度，尤其是在处理大量查询时。虽然这会增加内存的使用，但可��显著提高批量处理的效率。
- 少量查询：如果每个请求只查询少量的 IP 地址，那么使用 "BTREE" 模式可能更合适。"BTREE" 模式不需要预先加载整个数据库到内存中，适用于处理较少量的查询请求，可以减少内存的使用，同时保持良好的查询性能。
