sub_crawler

Crates.iosub_crawler
lib.rssub_crawler
version1.0.2
sourcesrc
created_at2024-11-26 07:53:34.591135
updated_at2024-11-27 07:42:10.930809
descriptionA fast, flexible subdomain enumeration tool
homepage
repositoryhttps://github.com/sylar-my/sub_crawler/
max_upload_size
id1461300
size30,291
(sylar-my)

documentation

README

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

Commit count: 25

cargo fmt