- Add DEMO.md and screenshots for bug-bounty-platform, hash-cracker, linux-cis-hardening-auditor, simple-port-scanner, simple-vulnerability-scanner, systemd-persistence-scanner, base64-tool, caesar-cipher, dns-lookup, metadata-scrubber-tool, network-traffic-analyzer, siem-dashboard - Link DEMO.md from project READMEs - Add .gitignore entries for DEMO-TRACKER and simple-port-scanner build dir - Restructure haskell-reverse-proxy with DDoS, Fingerprint, ML, RateLimit, WAF, Geo, and Honeypot modules; drop superseded research docs and old Makefile - Refresh siem-dashboard dashboard.png and rename alerts.png to alert-detail.png |
||
|---|---|---|
| .. | ||
| assets | ||
| dnslookup | ||
| learn | ||
| tests | ||
| .gitignore | ||
| .style.yapf | ||
| DEMO.md | ||
| LICENSE | ||
| README.md | ||
| justfile | ||
| pyproject.toml | ||
| uv.lock | ||
README.md
██████╗ ███╗ ██╗███████╗██╗ ██████╗ ██████╗ ██╗ ██╗██╗ ██╗██████╗
██╔══██╗████╗ ██║██╔════╝██║ ██╔═══██╗██╔═══██╗██║ ██╔╝██║ ██║██╔══██╗
██║ ██║██╔██╗ ██║███████╗██║ ██║ ██║██║ ██║█████╔╝ ██║ ██║██████╔╝
██║ ██║██║╚██╗██║╚════██║██║ ██║ ██║██║ ██║██╔═██╗ ██║ ██║██╔═══╝
██████╔╝██║ ╚████║███████║███████╗╚██████╔╝╚██████╔╝██║ ██╗╚██████╔╝██║
╚═════╝ ╚═╝ ╚═══╝╚══════╝╚══════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝
Professional DNS query CLI with Rich terminal output, reverse lookups, and WHOIS integration.
This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.
What It Does
- Query A, AAAA, MX, NS, TXT, CNAME, and SOA records with colored table output
- Reverse DNS lookup to resolve IP addresses back to hostnames
- Trace DNS resolution path from root servers to authoritative nameservers
- Batch lookups with concurrent queries for processing domain lists
- WHOIS integration for domain registration information
- JSON export for scripting and pipeline integration
Quick Start
uv tool install dnslookup-cli
dnslookup query example.com
[!TIP] This project uses
justas a command runner. Typejustto see all available commands.Install:
curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin
Commands
| Command | Description |
|---|---|
dnslookup query |
Query DNS records for a domain with colored table output |
dnslookup reverse |
Resolve an IP address back to its hostname |
dnslookup trace |
Trace the DNS resolution path from root to authoritative servers |
dnslookup batch |
Query multiple domains concurrently from a file |
dnslookup whois |
Retrieve WHOIS registration information for a domain |
Learn
This project includes step-by-step learning materials covering security theory, architecture, and implementation.
| Module | Topic |
|---|---|
| 00 - Overview | Prerequisites and quick start |
| 01 - Concepts | Security theory and real-world breaches |
| 02 - Architecture | System design and data flow |
| 03 - Implementation | Code walkthrough |
| 04 - Challenges | Extension ideas and exercises |
License
AGPL 3.0