BugScanX

All-in-One Tool for Finding SNI Bug Hosts

🔍 Bug Host Discovery • 🌐 SNI Host Scanning • 🛡️ HTTP Analysis • 📊 Host Intelligence

• 🎯 Overview
• ✨ Features
• ⚡ Quick Start
• 🔧 Installation
• 🛠️ Tools Documentation
• 🏗️ Architecture
• 🤝 Contributing
• ⚠️ Disclaimer
• 📞 Support

BugScanX is a specialized bug host discovery tool designed for finding working SNI/HTTP hosts that are suitable for tunneling applications. This tool helps users discover bug hosts that can be used to create configurations for various tunneling and VPN applications to enable unrestricted internet access.

Advanced multi-mode bug host scanning with specialized capabilities:

• Direct Scanning: HTTP/HTTPS bug host discovery with custom methods
• DirectNon302: Specialized scanning that excludes redirect responses (essential for bug hosts)
• SSL/SNI Analysis: TLS/SSL configuration analysis for SNI bug hosts
• Proxy Testing: Comprehensive proxy validation for tunneling compatibility
• Ping Scanning: Connectivity testing for discovered hosts
• Support for all HTTP methods and custom payload injection
• Multi-threaded concurrent processing

Professional subdomain discovery for expanding bug host lists:

• Passive Discovery: Leverages multiple API providers and search engines
• Batch Processing: Mass domain enumeration from target lists

Comprehensive IP intelligence for bug host clustering:

• Reverse IP Lookup: Discover all domains hosted on target IPs
• CIDR Range Processing: Bulk analysis of IP ranges
• Multi-Source Aggregation: Combines data from multiple sources

Advanced port scanning for service discovery with common tunneling ports (80, 443, 8080, 8443).

Comprehensive analysis for SNI bug hosts including DNS records and SSL certificate validation.

Professional-grade file processing with smart splitting, merging, deduplication, and filtering tools.

# Install from PyPI
pip install bugscan-x

# Primary command
bugscanx

# Alternative commands
bugscan-x
bx

    ╔╗ ╦ ╦╔═╗╔═╗╔═╗╔═╗╔╗╔═╗ ╦
    ╠╩╗║ ║║ ╦╚═╗║  ╠═╣║║║╔╩╦╝
    ╚═╝╚═╝╚═╝╚═╝╚═╝╩ ╩╝╚╝╩ ╚═

[1] HOST SCANNER          # Advanced bug host scanner with multiple modes
[2] SUBFINDER             # Subdomain enumeration with passive discovery modes
[3] IP LOOKUP             # Reverse IP lookup
[4] FILE TOOLKIT          # Bug host list management
[5] PORT SCANNER          # Port scanner to discover open ports
[6] DNS RECORD            # DNS record gathering
[7] HOST INFO             # Detailed bug host analysis
[8] HELP                  # Documentation and usage examples
[9] UPDATE                # Self-update tool
[0] EXIT                  # Quit application

Once you discover working bug hosts using BugScanX, you can use them to create configurations for various tunneling and VPN applications to bypass network restrictions.

• Python: 3.7 or higher
• Operating System: Windows, Linux, macOS, Android (Termux)
• Network: Internet connection

# Install latest stable version
pip install bugscan-x

# Install beta version
pip install --pre bugscan-x

# Clone repository
git clone https://github.com/Ayanrajpoot10/bugscanx.git
cd bugscanx

# Install in development mode
pip install -e .

BugScanX automatically installs the following dependencies:

beautifulsoup4   # HTML parsing and web scraping
dnspython        # DNS resolution and analysis
InquirerPy       # Interactive CLI prompts
packaging        # Version management
pyfiglet         # ASCII art generation
requests         # HTTP client library
rich             # Rich console output
tqdm             # Progress bars

Advanced bug host discovery with multiple scanning modes:

• Direct Mode: Standard HTTP/HTTPS bug host scanning
• DirectNon302 Mode: Excludes redirect responses (essential for clean bug hosts)
• SSL/SNI Mode: SNI hostname verification and TLS analysis
• Proxy Mode: Websocket upgrade testing and proxy validation

Professional subdomain enumeration using multiple sources:

• Certificate Transparency logs
• Search engines and APIs
• DNS records analysis
• Batch processing for multiple domains

Reverse IP analysis for related bug host discovery:

• Multi-source domain lookup
• CIDR range processing
• Historical hosting data

Advanced file processing operations:

[1] SPLIT FILE      # Divide large bug host lists
[2] MERGE FILES     # Combine multiple discoveries
[3] CLEAN FILE      # Extract clean domains
[4] DEDUPLICATE     # Remove duplicates
[5] FILTER BY TLD   # Filter by domain extension
[6] FILTER BY KEYWORD # Filter by criteria
[7] CIDR TO IP      # Expand network ranges
[8] DOMAIN TO IP    # Resolve to IP addresses

High-performance port enumeration:

• Common tunneling ports (80, 443, 8080, 8443, 8888)
• Full range scanning
• Service detection and connection testing

Comprehensive DNS intelligence:

• A, AAAA, CNAME, MX, NS, TXT records
• IPv4/IPv6 address resolution
• Name server analysis

Detailed host analysis and intelligence gathering:

• Network information and geolocation
• Web server analysis and fingerprinting
• SSL/TLS certificate analysis
• Security assessment and vulnerability detection

• Thread Count: Adjust concurrent threads (default: 50)
• Timeout Settings: Configure connection timeouts
• Port Lists: Customize target ports
• HTTP Methods: Select specific methods for discovery

• File Formats: TXT, JSON, CSV output options
• Result Filtering: Filter by response codes and content types
• Logging Levels: Adjust verbosity for debugging

• Proxy Configuration: Use proxy servers for scanning
• DNS Settings: Configure custom DNS servers
• User Agent: Customize HTTP user agent strings

• DirectNon302 Mode: Exclude redirect responses for clean bug hosts
• SSL/SNI Configuration: TLS version preferences and certificate validation
• Timeout Settings: SSL handshake and connection timeouts

BugScanX is built with a modular architecture for extensibility and performance:

• Module Handler: Dynamic module loading and execution
• Concurrency Engine: Multi-threaded processing with ThreadPoolExecutor
• Rich Console Interface: Advanced console output with progress tracking
• File Management: Smart file operations and processing
• Network Layer: HTTP/HTTPS requests with proxy support

We welcome contributions from the security community!

Create an issue with:

• Clear description of the issue
• Steps to reproduce
• Environment details (OS, Python version, BugScanX version)
• Expected vs actual behavior

Include:

• Feature description and use case
• Implementation ideas

BugScanX is designed for educational purposes and legitimate testing only:

• ✅ Learning: Understanding tunneling and bypass techniques
• ✅ Personal Use: Testing your own networks and systems
• ✅ Research: Academic and educational research
• ✅ Legal Testing: Authorized penetration testing

• 🔒 Legal Compliance: Always comply with local laws
• 📋 Permission Required: Only test systems you own or have permission to test
• 🤝 Respect Networks: Avoid overwhelming target servers
• 🛡️ Ethical Use: Use discovered bug hosts responsibly
• ❌ No Unauthorized Testing: Never scan without proper authorization

By using BugScanX, you agree to use the tool only for legitimate purposes and take full responsibility for your actions.

The developers are not responsible for any misuse of this tool. Users must ensure compliance with all applicable laws.

• Telegram: @BugScanX - Community discussions
• GitHub Issues: Report bugs and request features
• GitHub Discussions: Community Q&A

• Built-in Help: Use option [10] HELP in the application
• Wiki: Comprehensive documentation