exorrtech/exorr-subdomain-monitor
GitHub: exorrtech/exorr-subdomain-monitor
持续子域名发现与变更追踪工具,通过多源发现和历史快照 diff 帮助用户监控目标域名攻击面的动态变化。
Stars: 0 | Forks: 0
# EXORR 子域名监控


[](https://github.com/exorrtech/exorr-subdomain-monitor/actions/workflows/ci.yml)

由 ∅ EXORR 提供的**持续子域名发现与变更追踪**。
随时间推移监控目标域名的新增和移除的子域名。集成了用于被动侦察的 subfinder,以及作为后备方案的内置 DNS 枚举。检测两次运行之间的变更,并生成带有时间戳的快照。
## 功能
- **多源发现** — 集成 subfinder + DNS 枚举后备方案
- **变更检测** — 自动将当前结果与上一次快照进行 diff 比较
- **带时间戳的快照** — 每次运行都会保存为 JSON 格式,用于历史追踪
- **新增/移除提醒** — 即时查看出现或消失的子域名
- **历史视图** — 列出所有过往扫描及其数量统计
- **零依赖** — 纯 Python,无需任何外部包
## 技术栈
`Python 3.9+` `subfinder` `DNS` `JSON Snapshots`
`Python 3.9+` `CLI` `JSON/Markdown/HTML Reporting`
## 安装
```
git clone https://github.com/exorrtech/exorr-subdomain-monitor.git
cd exorr-subdomain-monitor
pip install -e .
```
## 使用说明
### 首次扫描(所有子域名均为新增)
```
exorr-subdomain-monitor example.com
```
### 第二次扫描(检测变更)
```
exorr-subdomain-monitor example.com
```
输出会显示自上次运行以来新增和移除的子域名。
### 仅使用 DNS 枚举(不使用 subfinder)
```
exorr-subdomain-monitor example.com --tools dns
```
### 查看历史快照
```
exorr-subdomain-monitor example.com --history
```
### 保存报告
```
exorr-subdomain-monitor example.com -o report.md --format markdown
```
### 自定义数据目录
```
exorr-subdomain-monitor example.com -d /path/to/data
```
## 发现工具
| 工具 | 方法 | 要求 |
|------|--------|-------------|
| `subfinder` | 被动子域名枚举 | 已安装 [subfinder](https://github.com/projectdiscovery/subfinder) |
| `dns` | 主动枚举 50+ 个常见前缀的 DNS | `dig`(通常是预安装的) |
工具按顺序运行,结果将合并。如果未找到 subfinder,将自动运行 DNS 枚举。
## 快照格式
每次运行都会保存一个 JSON 快照:
```
{
"domain": "example.com",
"timestamp": "2026-01-01T12:00:00+00:00",
"count": 42,
"subdomains": ["api.example.com", "www.example.com", ...]
}
```
快照默认存储在 `./exorr-monitor-data//` 中。
## 项目结构
```
exorr-subdomain-monitor/
exorr_subdomain_monitor/
__init__.py
cli.py # CLI interface
monitor.py # Core monitoring engine
report.py # Report generator
tests/
test_monitor.py
pyproject.toml
README.md
LICENSE
```
## 运行测试
```
pip install -e ".[dev]"
pytest tests/ -v
```
*Walk with the void. ∅ EXORR*
标签:GitHub, Homebrew安装, Python, 子域名监控, 实时处理, 无后门, 资产测绘, 逆向工具