#ip #ipv4 #ipv6 #ip-geolocation

czdb

A pure Rust library for parsing CZDB-format IP databases

2 releases

0.1.1 Nov 23, 2024
0.1.0 Nov 21, 2024

#132 in Geospatial

Download history 287/week @ 2024-11-18 33/week @ 2024-11-25 26/week @ 2024-12-09

346 downloads per month

MIT license

18KB
245 lines

czdb-rs

Crates.io Documentation MIT licensed

czdb-rs is a simple and fast Rust library for parsing CZDB-format IP databases. It supports both IPv4 and IPv6 lookups and uses memory-mapped files (mmap) to keep memory usage low and speed up disk access. Perfect for quick IP geolocation queries with minimal overhead.

Note: The database file and key must be obtained from www.cz88.net.

Usage

cargo add czdb
use czdb::Czdb;

let db_path = "path/to/your/czdb_file";
let key = "your_base64_key";
let czdb = Czdb::new(db_path, key).expect("Failed to load database");
use std::net::IpAddr;
let ip: IpAddr = "8.8.8.8".parse().unwrap();
if let Some(location) = czdb.search(ip) {
    println!("Location for IP {}: {}", ip, location);
} else {
    println!("No location data found for IP {}", ip);
}

Dependencies

~2.4–3MB
~62K SLoC