elementalsouls/SubdomainX

GitHub: elementalsouls/SubdomainX

一款基于Python的异步子域名枚举工具,整合多源被动查询、暴力破解、排列扫描与HTTP探测,解决一次性发现大量子域的问题。

Stars: 0 | Forks: 0

# SubdomainX Comprehensive subdomain enumeration tool that combines **16+ passive OSINT sources**, **DNS brute forcing**, **permutation scanning**, **recursive enumeration**, and **HTTP probing** into a single fast, async-powered tool. ## 功能 | Technique | Description | |-----------|-------------| | **Passive OSINT (16 free sources)** | crt.sh, CertSpotter, HackerTarget, AlienVault OTX, ThreatMiner, AnubisDB, URLScan, RapidDNS, WebArchive, BufferOver, DNSRepo, Shrewdeye, CommonCrawl, Digitorus, Riddler, FullHunt | | **API-key sources (6 optional)** | VirusTotal, SecurityTrails, Shodan, Censys, BinaryEdge, ProjectDiscovery Chaos | | **DNS Zone Transfer** | AXFR attempts against all nameservers | | **DNS Brute Force** | High-speed async brute forcing with wildcard detection | | **Permutation Scanning** | Generates and tests prefix/suffix combinations of discovered subdomains | | **Recursive Enumeration** | Finds subdomains of subdomains | | **HTTP Probing** | Resolves DNS, checks HTTP/HTTPS, extracts page titles and server headers | | **Wildcard Detection** | Automatically detects and filters wildcard DNS to prevent false positives | ## 安装 ``` cd SubdomainX pip install -r requirements.txt ``` ## 用法 ``` # 基础被动 + 暴力破解 python -m subdomainx example.com # 保存结果 python -m subdomainx example.com -o results.txt # plain text python -m subdomainx example.com -o results.json # JSON with metadata python -m subdomainx example.com -o results.csv # CSV # 完整扫描(所有技术) python -m subdomainx example.com --all -o results.json # 仅被动(不使用暴力破解) python -m subdomainx example.com --no-bruteforce # 自定义词表和并发 python -m subdomainx example.com -w /path/to/wordlist.txt -t 1000 # 使用 HTTP 探测 python -m subdomainx example.com --probe # 独立技术 python -m subdomainx example.com --permutations python -m subdomainx example.com --recursive --recursive-depth 3 ``` ## 选项 | Flag | Description | |------|-------------| | `-o, --output` | Output file (.txt, .json, .csv) | | `-w, --wordlist` | Custom wordlist for brute forcing | | `-t, --concurrency` | Concurrent DNS queries (default: 500) | | `--no-bruteforce` | Skip DNS brute forcing | | `--permutations` | Enable permutation scanning | | `--recursive` | Enable recursive enumeration | | `--recursive-depth` | Recursion depth (default: 2) | | `--probe` | Probe HTTP/HTTPS for all results | | `--all` | Enable all techniques | ## API 密钥(可选) Set via environment variables or `~/.subdomainx/config.json`: ``` export VIRUSTOTAL_API_KEY=your_key export SECURITYTRAILS_API_KEY=your_key export SHODAN_API_KEY=your_key export CENSYS_API_KEY=id:secret export BINARYEDGE_API_KEY=your_key export CHAOS_API_KEY=your_key ``` Or create `~/.subdomainx/config.json`: ``` { "api_keys": { "virustotal": "your_key", "securitytrails": "your_key", "shodan": "your_key", "censys": "id:secret", "binaryedge": "your_key", "chaos": "your_key" } } ``` ## 架构 ``` SubdomainX/ ├── subdomainx/ │ ├── __init__.py # Package metadata │ ├── __main__.py # CLI + orchestrator │ ├── passive.py # 22 passive OSINT sources │ ├── active.py # Brute force, zone transfer, permutations, recursive │ └── resolver.py # DNS resolution + HTTP probing ├── wordlists/ │ └── subdomains.txt # Built-in wordlist (~3000 entries) ├── requirements.txt └── README.md ``` ## 它如何超越其他工具 1. **More sources** — 16 free passive sources + 6 API sources queried concurrently 2. **Smart brute forcing** — Wildcard detection prevents false positives; multiple DNS resolvers for speed 3. **Permutation engine** — Discovers subdomains that brute forcing misses by combining found patterns 4. **Recursive discovery** — Automatically enumerates sub-subdomains 5. **All-in-one** — No need to chain Subfinder → Amass → HTTPX; one tool does it all 6. **Async everything** — Built on asyncio/aiohttp for maximum throughput
标签:Ask搜索, AXFR, DNS探测, ESC4, HTTP探测, OSINT, ProjectDiscovery, Python, SEO, VirusTotal, Web标题提取, 反取证, 域名枚举, 子域名接管, 子域名枚举, 安全评估, 异步并发, 排列扫描, 数据保护, 无后门, 服务器头探测, 系统安全, 被动信息收集, 计算机取证, 证书透明度, 逆向工具, 递归枚举, 通配符DNS检测