exorrtech/recon-toolkit
GitHub: exorrtech/recon-toolkit
该工具将 subfinder、httpx、nmap 和 nuclei 编排为一条自动化侦察流水线,实现对目标攻击面的子域名枚举、存活探测、端口扫描与漏洞发现的端到端覆盖。
Stars: 1 | Forks: 0
# EXORR Recon 工具包


[](https://github.com/exorrtech/recon-toolkit/actions/workflows/ci.yml)

由 ∅ EXORR 提供的**自动化攻击面发现 pipeline**。
将 subfinder、httpx、nmap 和 nuclei 编排为一个单一的自动化 recon pipeline。提供具备逐阶段执行、结构化输出和 JSON 报告功能的 Python CLI。
## 功能
- **多阶段 pipeline** — subfinder -> httpx -> nmap -> nuclei,完全自动化
- **选择性执行** — 运行单个阶段或完整链路
- **结构化输出** — 包含子域名数量、存活主机、开放端口和漏洞发现等内容的 JSON 结果
- **优雅降级** — 报告缺失的工具,而不会导致程序崩溃
- **带时间戳的结果** — 每次运行都会保存到井然有序的输出目录中
- **内置 Bash 脚本** — 包含 `recon.sh`,用于轻量级的基于 shell 的 recon
## 环境要求
- Python 3.9+
- 可选(自动检测):[subfinder](https://github.com/projectdiscovery/subfinder)、[httpx](https://github.com/projectdiscovery/httpx)、[nmap](https://nmap.org/)、[nuclei](https://github.com/projectdiscovery/nuclei)
## 技术栈
`Python 3.9+` `subfinder` `httpx` `nmap` `nuclei` `JSON Reporting`
`Python 3.9+` `CLI` `JSON/Markdown/HTML Reporting`
## 安装说明
```
git clone https://github.com/exorrtech/recon-toolkit.git
cd recon-toolkit
pip install -e .
```
## 使用方法
### 完整 pipeline
```
exorr-recon example.com
```
### 仅运行特定阶段
```
exorr-recon example.com --phases subfinder,httpx
```
### 启用详细输出与报告
```
exorr-recon example.com --verbose --report results.json
```
### 使用 bash 脚本
```
./recon.sh example.com --phase all
./recon.sh example.com --phase subfinder
```
## Pipeline 阶段
| 阶段 | 工具 | 功能描述 |
|-------|------|-------------|
| **subfinder** | ProjectDiscovery subfinder | 被动子域名枚举 |
| **httpx** | ProjectDiscovery httpx | 探测存活的 HTTP/HTTPS 主机 |
| **nmap** | Nmap | 扫描 Top 100 端口并进行服务检测 |
| **nuclei** | ProjectDiscovery nuclei | 使用模板进行漏洞扫描 |
每个阶段都会将其输出馈送到下一个阶段。缺失的工具将被跳过,并会显示清晰的错误信息。
## 输出
结果将保存至 `./recon-output//`:
- `subdomains.txt` — 发现的子域名
- `live_hosts.json` — 经过 HTTP 探测的存活主机
- `nmap_scan.txt` — Nmap 输出
- `nuclei_results.txt` — Nuclei 发现
JSON 报告包含以下摘要信息:
```
{
"summary": {
"subdomains": 50,
"live_hosts": 12,
"open_ports": 8,
"vulnerabilities": 3
}
}
```
## 项目结构
```
recon-toolkit/
exorr_recon/
__init__.py
__main__.py
cli.py # CLI interface
engine.py # Core pipeline engine
tests/
test_engine.py
recon.sh # Bash script alternative
pyproject.toml
README.md
LICENSE
```
## 运行测试
```
pip install -e ".[dev]"
pytest tests/ -v
```
*与虚空同行。 ∅ EXORR*
标签:Docker容器, Python, 实时处理, 密码管理, 插件系统, 攻击面发现, 文档结构分析, 无后门, 网络探针, 自动化侦查, 运行时操纵, 逆向工具