4m3rr0r/SubreconGemini
GitHub: 4m3rr0r/SubreconGemini
SubreconGemini 是一款结合 AI 建议、证书透明度日志与字典爆破的异步子域名发现与存活验证工具。
Stars: 17 | Forks: 5
# SubreconGemini 🛡️🔍
**SubreconGemini** 是一款高性能的子域名发现工具，它结合了 **Google Gemini AI**、**证书透明度日志**和**字典爆破**来发现并验证存活子域名。
## 🚀 功能
- **混合发现方法**
- 🤖 **AI 驱动** — 使用 Google Gemini API 根据上下文建议可能的子域名。
- 📜 **证书透明度** — 查询 `crt.sh` 从 SSL/TLS 证书中获取子域名。
- 📖 **字典爆破** — 使用可自定义的字典进行枚举。
- **智能验证**
- DNS 解析附带泛解析检测，以减少误报。
- 可选的 HTTP 探测，用于检测存活服务并获取状态码 + 页面标题。
- **高速度**
- 完全异步（`asyncio` + `aiohttp`）以实现最大并发。
- **丰富的输出**
- 通过 `rich` 实现颜色编码的控制台输出。
- 生成 `.txt`（原始列表）和 `.csv`（详细信息）报告。
- **灵活的输入**
- 扫描单个域名（`-d`）或从文件中扫描多个域名（`-l`）。
## 📦 环境要求
- **Python 3.7+**
- 安装依赖项：
```
pip install -r requirements.txt
```
## 配置说明
AI 发现功能需要一个 **Google Gemini API Key**。你可以从 [Google AI Studio](https://aistudio.google.com/app/apikey) 获取一个。
## 用法
```
usage: SubreconGemini.py [-h] (-d DOMAIN | -l LIST) [--scan {fast,normal,full}] [--ports PORTS] [--dns-only] [--web-only] [--verify-tls] [--no-verify-tls] [--proxy PROXY] [--output-dir OUTPUT_DIR] [--json] [--html] [--max-http MAX_HTTP] [--max-dns MAX_DNS] [--ai] [--ai-count AI_COUNT] [--gemini-key GEMINI_KEY] [--gemini-model GEMINI_MODEL]
Subrecon (async) – Focused Subdomain Discovery
options:
-h, --help show this help message and exit
-d, --domain DOMAIN Target domain (e.g., example.com) (default: None)
-l, --list LIST Path to a file with target domains (default: None)
--scan {fast,normal,full}
Port scan preset {fast | normal | full} (default: normal)
--ports PORTS Comma-separated ports to override preset (e.g., 80,443,8080) (default: None)
--dns-only Only perform DNS enumeration/verification (default: False)
--web-only Keep only hosts with web responses (default: False)
--verify-tls Verify TLS certificates (default on) (default: True)
--no-verify-tls Do not verify TLS certificates (default: True)
--proxy PROXY HTTP/S proxy (e.g., http://127.0.0.1:8080) (default: None)
--output-dir OUTPUT_DIR
Output directory (default: recon_results)
--json Also write JSON results (default: False)
--html Also write HTML report (default: False)
--max-http MAX_HTTP Max concurrent HTTP requests (default: 220)
--max-dns MAX_DNS Max concurrent DNS queries (default: 800)
--ai Enable Gemini AI seeding for additional candidates (default: False)
--ai-count AI_COUNT How many AI labels to request (default: 150)
--gemini-key GEMINI_KEY
Gemini API key (or set GEMINI_API_KEY) (default: None)
--gemini-model GEMINI_MODEL
Gemini model name (default: gemini-1.5-flash)
```
## 使用示例
```
python SubreconGemini.py -d google.com --scan full --ai --gemini-key API_KEY --proxy http://127.0.0.1:8080 --html
```
标签：GitHub, Python, 子域名枚举, 实时处理, 无后门, 系统安全, 计算机取证, 资产测绘, 逆向工具