Skip to content
JordaoMbambuPublic

About

Fast parallel subdomain alive checker - classifies live, dead, and erroring subdomains from a list

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Subdomain Alive Checker

A fast, parallel Bash tool that takes a list of subdomains and determines which ones are alive, returning HTTP errors, or completely unreachable.

Features

  • Parallel scanning -- processes up to 30 subdomains concurrently (configurable)
  • HTTPS-first with HTTP fallback -- tries HTTPS, automatically falls back to HTTP
  • Automatic classification -- sorts results into alive (2XX/3XX), error (4XX/5XX), and dead (timeout/DNS failure)
  • Page title extraction -- captures the HTML <title> tag for quick identification
  • CSV export -- generates a full CSV report alongside individual result files
  • Wildcard handling -- strips wildcard prefixes (*.example.com) and deduplicates input

Requirements

  • Bash 4+
  • curl
  • xargs (optional, used for parallel execution; built-in fallback included)

Installation

git clone https://github.com/<your-username>/subdomain-alive-checker.git
cd subdomain-alive-checker
chmod +x subdomain_check.sh

Usage

./subdomain_check.sh <subdomains.txt>

Input format

A plain text file with one subdomain per line:

mail.example.com
admin.example.com
dev.example.com
api.example.com

Lines containing only whitespace are ignored. Wildcard entries (*.example.com) are automatically cleaned.

Output

A timestamped results_YYYYMMDD_HHMMSS/ directory is created alongside the input file, containing:

File Description
valid.txt Subdomains that responded with HTTP 2XX/3XX
errors.txt Subdomains that returned HTTP 4XX/5XX
dead.txt Subdomains that timed out or failed DNS lookup
all_results.csv Complete results in CSV (domain, code, status, title, redirect)

Example output

============================================================
  Subdomain Alive Checker -- Scanning 5 domains (x30)
============================================================

  [ALIVE] mail.example.com                                [200] Example Mail
  [DEAD]  admin.example.com                               no response
  [ERROR] dev.example.com                                 [403] Forbidden
  [ALIVE] www.example.com                                 [200] Example Domain
  [DEAD]  test.example.com                                no response

============================================================
  [ALIVE] Reachable (2XX/3XX) : 2
  [ERROR] HTTP errors (4XX/5XX): 1
  [DEAD]  Unreachable          : 2
============================================================

Configuration

Edit the variables at the top of subdomain_check.sh to adjust behavior:

Variable Default Description
PARALLEL 30 Number of concurrent requests
TIMEOUT 7 Timeout per domain in seconds

Legal Disclaimer

This tool is intended for authorized security testing, bug bounty programs, and educational purposes only. You are solely responsible for ensuring you have proper authorization before scanning any domain or subdomain. Unauthorized scanning of systems you do not own or have explicit permission to test may violate applicable laws.

The author assumes no liability for misuse of this tool.

License

MIT License. See LICENSE for details.

About

Fast parallel subdomain alive checker - classifies live, dead, and erroring subdomains from a list

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages