Home Original page

GitHub - ErvisTusha/deepdns

Version License Bash

DeepDNS is an advanced DNS enumeration tool designed for security professionals and enthusiasts. It offers a comprehensive set of features for discovering subdomains and analyzing DNS records efficiently.

Features

  • Advanced DNS Enumeration: Multiple scanning modes including passive data sources and active probing techniques
  • Recursive Scanning: Discover subdomains recursively with configurable depth
  • Pattern Recognition: Intelligent subdomain discovery using pattern analysis
  • Virtual Host Scanning: Identify virtual hosts with customizable ports and response filtering
  • Multithreading: High-performance concurrent processing with adjustable thread counts
  • Smart Resolver Management: Automatic resolver health monitoring and rotation
  • API Integration: Seamless integration with SecurityTrails, VirusTotal, and Censys
  • Robust Error Handling: Graceful interrupt handling and comprehensive error recovery
  • Protocol Detection: Automatic HTTP/HTTPS protocol detection for virtual host scanning
  • Advanced Logging: Multiple log levels with detailed diagnostics capabilities
  • Progress Tracking: Real-time progress visualization with detailed status updates
  • Resource Management: Efficient cleanup and memory management
  • Flexible Output: Configurable output formats with filtering options

Installation

To install DeepDNS globally, run:

Usage

Basic usage:

Core Options

  • -h, --help : Show help message.
  • -v, --version : Show version information.
  • -D, --debug [file] : Enable debug mode (default log file: ~/.deepdns/logs/debug.log).
  • -V, --verbose : Enable verbose output.

Scan Options

  • -d, --domain <domain> : Target domain to scan
  • -w, --wordlist <file> : Custom wordlist file
  • -o, --output <file> : Output file location
  • -R, --resolver <file> : Custom DNS resolver file
  • -t, --threads <number> : Thread count (1-100, default: 10)
  • -p, --passive : Enable passive scanning
  • -a, --active : Enable active scanning
  • -r, --recursive [depth] : Enable recursive scanning
  • --pattern : Enable pattern recognition
  • --vhost : Enable virtual host scanning
  • --vhost-port <ports> : Custom virtual host ports
  • --vhost-filter <filter> : Response filtering options
  • --vhost-filter-value <value> : Filter criteria value
  • --raw : Enable raw output format

Management Commands

  • install : Install DeepDNS globally.

  • update : Update DeepDNS to the latest version.

  • Basic scan:

  • Passive scan:

    deepdns -d example.com -p

  • Recursive active scan with pattern recognition:

    deepdns -d example.com -a --pattern -r 2

  • Full scan with custom settings:

    deepdns -d example.com -a -t 20 \
  -w wordlist.txt -o output.txt \
  -R resolvers.txt -p -r 3 \
  --vhost --vhost-port 80,443,8000,8443 \
  --vhost-filter status --vhost-filter-value 200

Updates and Uninstallation

  • Update DeepDNS:

  • Uninstall DeepDNS:

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

DeepDNS is released under the MIT License.

Contact