CloakProbe v0.1.4

Privacy-first IP information service behind Cloudflare.

What's Changed

Added

• AS name (as-name) field extracted from RIR data for more accurate AS naming
  • RPSL parser now extracts as-name field from aut-num objects
  • Org DB v2 format stores as_name per organization record
  • AS name from RIR data takes precedence over ip2asn (fixes truncated names like ASN-VODAFONE- → ASN-VODAFONE-HU)

Changed

• Comprehensive handler tests for all endpoint handlers
  • Health handler tests (1 test)
  • Info handler tests (4 tests: basic, ASN data, nginx mode, invalid IP)
  • Plain handler tests (5 tests: basic, ASN data, nginx mode, invalid IP, client hints)
  • HTML handler tests (4 tests: basic, ASN data, nginx mode, missing IP)
  • Privacy handler tests (1 test)
  • Total: 15 new handler tests, bringing total test count to 70

Changed

• Org DB format upgraded to v2 (adds as_name field, backward compatible reader for v1)
• CSV format for org builders now includes 9 fields: asn,as_name,org_id,org_name,country,rir,org_type,abuse_contact,last_updated

Fixed

• Fixed quick-xml 0.38 API compatibility (GeneralRef events for XML entity handling)
• Fixed truncated AS names from iptoasn.com (e.g., AS21334 now shows ASN-VODAFONE-HU instead of ASN-VODAFONE-)

Previously Added

• IP Address Details card UI improvements
  • IPv4 hexadecimal format changed from dotted notation (C0.A8.01.01) to 0x prefix format (0xC0A80101) without dots
  • Removed redundant /24 Subnet and Subnet Size rows from IPv4 details
  • Removed redundant /64 Network and Network Size rows from IPv6 details
• Codebase refactoring for improved maintainability and performance
  • Modular handler structure: Split handlers/mod.rs into separate handler modules
    • handlers/info.rs - JSON API handler
    • handlers/html.rs - HTML UI handler
    • handlers/plain.rs - Plain text handler
    • handlers/privacy.rs - Privacy policy handler
    • handlers/health.rs - Health check handler
    • handlers/mod.rs - Module exports and AppState definition
  • Extracted Cloudflare header processing to dedicated headers/cloudflare.rs module
  • Moved utility functions to focused modules (utils/sanitize.rs, utils/dnt.rs, utils/ip.rs)
  • Cached Tera template engine in AppState to avoid re-initialization on each request
  • Optimized sanitization functions to accept Option<&str> and reduce string cloning
  • Improved code organization: connection, nginx, client, and cloudflare header extraction now in separate modules
  • Formatter helpers now actively used: HTML, JSON, and plain text handlers now use formatter helper functions
    • Reduced code duplication: ~400 lines of repetitive context building code replaced with reusable helpers
    • Header item building logic extracted to formatters/html.rs (geo location, network, connection, security, proxy items)
    • Plain text output now uses formatters/plain.rs helpers for consistent formatting
  • String cloning optimization: Reduced unnecessary cloning by using references (&str) instead of owned strings
    • Cloudflare header extraction now uses references (geo_ref, network_ref, etc.) instead of cloning values
    • Reduced memory allocations and improved performance, especially for high-traffic scenarios
  • Template context building optimization: Pre-sized context HashMap and batch operations using formatter helpers
    • Context building now uses helper functions that batch insertions efficiently
    • Reduced HashMap reallocations during context construction

Downloads

Package Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)
• README.md, LICENSE, CHANGELOG.md

Note: Multi-RIR organization database is not pre-built. Run /opt/cloakprobe/scripts/update_org_db.sh after installation to download organization data from all 5 RIRs.

Quick Start

# Download and extract (example for x86_64)
curl -LO https://github.com/drmckay/cloakprobe/releases/download/v0.1.4/cloakprobe-0.1.4-linux-x86_64.tar.gz
tar -xzf cloakprobe-0.1.4-linux-x86_64.tar.gz
cd cloakprobe-0.1.4-linux-x86_64
# Verify checksum
sha256sum -c ../cloakprobe-0.1.4-linux-x86_64.tar.gz.sha256
# Setup configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation and deployment instructions, see the documentation.

Full Changelog: v0.1.3...v0.1.4

Nightly Build - 2026年06月13日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月12日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月11日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月10日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月09日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月08日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月07日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月06日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.

Nightly Build - 2026年06月05日

This is an automated nightly build containing the latest code and updated databases.

Contents

Each package includes:

• cloakprobe - Main binary
• asn_builder - ASN database builder
• org_builder, org_builder_rpsl, org_builder_arin - Multi-RIR organization database builders
• cloakprobe.example.toml - Example configuration file
• data/asn_db.bin - Pre-built ASN database (from iptoasn.com)
• templates/ - HTML templates (index.html.tera, privacy.html.tera)
• scripts/ - Database update scripts (including multi-RIR org update)
• systemd/ - Systemd service files (single and multi-instance)
• docs/ - Deployment documentation (nginx setup guide)

Note: Multi-RIR organization database is not pre-built. Run update_org_db.sh after installation.

Installation

# Download and extract
tar -xzf cloakprobe-x86_64-unknown-linux-gnu.tar.gz
cd cloakprobe-x86_64-unknown-linux-gnu
# Copy and edit configuration
sudo mkdir -p /etc/cloakprobe
sudo cp cloakprobe.example.toml /etc/cloakprobe/cloakprobe.toml
sudo nano /etc/cloakprobe/cloakprobe.toml
# Run
./cloakprobe -c /etc/cloakprobe/cloakprobe.toml

For full installation instructions, see the README and docs/nginx-deployment.md.

⚠️ Note: This is a pre-release build. Use at your own risk.