#subdomain #networking #recon #scanner

app sub_crawler

A fast, flexible subdomain enumeration tool

5 releases (3 stable)

1.0.2 Nov 27, 2024
1.0.1 Nov 26, 2024
0.1.1 Nov 26, 2024
0.1.0 Nov 26, 2024

#196 in Network programming

Download history 451/week @ 2024-11-23 48/week @ 2024-11-30

499 downloads per month

MIT license

16KB
214 lines

Sub_Crawler 🌐🔍

Overview

Sub_Crawler is a fast and flexible subdomain enumeration tool designed to help security researchers, penetration testers, and network administrators discover subdomains of a target domain quickly and efficiently.

Features

  • 🚀 High-Performance: Multithreaded scanning for rapid subdomain discovery
  • 📋 Flexible Wordlists: Multiple built-in wordlist options
  • 🔧 Customizable: Support for custom wordlists and thread configurations
  • 🎯 Easy to Use: Simple command-line interface

Prerequisites

  • Rust programming language (latest stable version recommended)
  • Optional: SecLists wordlist collection

Installation

From Source

  1. Clone the repository:
git clone https://github.com/sylar-my/sub_crawler.git
cd sub_crawler
  1. Build the project:
cargo build --release
  1. Install the binary:
cargo install --path .

Binary Release

Download the latest release from the Releases page.

Usage

Basic Scanning

sub_crawler example.com

Advanced Options

# Use top 5000 wordlist with 20 threads
sub_crawler -w top5000 -t 20 example.com

# Use a custom wordlist
sub_crawler -w custom -c /path/to/custom_wordlist.txt example.com

Wordlist Options

  • light: Default lightweight wordlist
  • top5000: Top 5000 most common subdomain names
  • top20000: Extended subdomain list
  • top110000: Comprehensive subdomain collection
  • custom: User-provided custom wordlist

Configuration

Environment Variable

Set the SecLists path:

export SECLISTS_PATH=/path/to/seclists

Command Line Options

Option Description Default
-w, --wordlist Wordlist type light
--seclists-path Custom SecLists directory path -
-c, --custom-wordlist Path to custom wordlist -
-t, --threads Number of concurrent threads 10

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Project Link: https://github.com/sylar-my/sub_crawler

Acknowledgments

Dependencies

~4–12MB
~122K SLoC