exorrtech/exorr-subdomain-monitor

GitHub: exorrtech/exorr-subdomain-monitor

持续子域名发现与变更追踪工具,通过多源发现和历史快照 diff 帮助用户监控目标域名攻击面的动态变化。

Stars: 0 | Forks: 0

# EXORR 子域名监控 ![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue) ![MIT License](https://img.shields.io/badge/license-MIT-green) [![CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/06/7ac5fad10c091000.svg)](https://github.com/exorrtech/exorr-subdomain-monitor/actions/workflows/ci.yml) ![Version](https://img.shields.io/badge/version-1.0.0-orange) 由 ∅ 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, 子域名监控, 实时处理, 无后门, 资产测绘, 逆向工具