用于红队工作的子域名枚举与侦察控制台。支持被动与主动收集、深度关联分析、存储桶发现,以及 msfconsole 风格的交互式 shell。
一款用于红队工作的子域名枚举与侦察工具。核心功能无需 API 密钥,既可以作为一次性 CLI 运行,也可以作为持久化的、msfconsole 风格的交互式控制台运行。
仅可对已获授权测试的域名运行此工具。详情请参阅下文“法律”部分。
setcap),并自动回退到普通 TCP connect,同时对首次未响应的端口进行重试。set、show options、run、setup)和一次性标志驱动的 CLI,二者均构建于同一引擎之上。git clone https://github.com/Rebellionxkid/NoWRecon
cd NoWRecon
pip install -r requirements.txt
对于真正的 SYN 扫描(若不使用它,工具会回退到 TCP connect):
sudo setcap cap_net_raw+ep $(readlink -f $(which python3))
控制台(建议从这里开始):
python -m subscout.cli
显示横幅,引导你完成引导式设置(选择一种模式: passive / active / deep / custom),提供默认预设或手动 配置每一项设置,然后进入提示符:
nowrecon (example.com) > show options
nowrecon (example.com) > set MODE deep
nowrecon (example.com) > set EXPAND_ORG true
nowrecon (example.com) > run
...
nowrecon (example.com) > set DOMAIN other-target.com
nowrecon (other-target.com) > run
nowrecon (other-target.com) > exit
控制台在一次扫描后不会退出。命令:
set OPTION VALUE:更改设置,例如 set MODE deep。unset OPTION:将设置重置回默认值。show options:显示所有设置及其当前值的表格。show banner / banner:重新打印启动横幅。setup:重新运行引导式配置流程。run(或 scan):使用当前设置开始扫描。help:列出所有命令。在扫描过程中,随时按 Enter 可跳过当前阶段并 继续进入下一阶段。
标志,一次性运行:
python -m subscout.cli example.com --mode deep --buckets --expand-org
| CLI 参数 | 控制台选项 | 描述 |
|---|---|---|
--mode | MODE | passive / active / deep |
--out-dir | OUT_DIR | 写入 json/csv/txt 的位置 |
--wordlist | WORDLIST | 自定义暴力破解字典 |
--db | DB | SQLite 历史/差异数据库的路径 |
--ptr-prefix | PTR_PREFIX | 深度模式 PTR 扫描的 CIDR 范围 |
--no-vhost | NO_VHOST | 禁用深度模式 vhost 探测 |
--dns-rate | DNS_RATE | 每个解析器每秒最大 DNS 查询数 |
--ip-rate | IP_RATE | 针对单个目标 IP 每秒最大 HTTP 请求数 |
--connect-timeout | CONNECT_TIMEOUT | TCP 连接端口扫描中每次尝试的超时时间 |
--expand-org | EXPAND_ORG | 同时扫描同级组织域名,而不仅仅是列出它们 |
--expand-mode | EXPAND_MODE | 用于同级域名子扫描的模式 |
--buckets | BUCKETS | 根据品牌猜测云存储桶名称 |
--deep-brute | DEEP_BRUTE | 对已发现的名称进行额外的模式变异轮次 |
--github-token | GITHUB_TOKEN | 用于 GitHub 代码搜索侦察的令牌 |
--nsec-walk | NSEC_WALK | 尝试完整的 NSEC 区域遍历(仅限普通 NSEC) |
--user-agent | USER_AGENT | 每个请求的自定义 User-Agent |
--random-user-agent | RANDOM_USER_AGENT | 整个运行过程中使用随机真实浏览器 User-Agent |
-v / --verbose | VERBOSE | 显示每个阶段的日志行 |
--debug | DEBUG | 显示每个名称是由哪个来源发现的 |
注意事项:
DEAD,请提高 CONNECT_TIMEOUT
(默认 3 秒)。在没有 root/setcap 的情况下,端口扫描会回退到
普通 TCP 连接,而目标负载过高,或本机自身
因大规模并发扫描而繁忙,都可能导致真正开放的
端口错过短暂的时间窗口。每个端口已经会自动
重试一次;提高超时只是给每次尝试更多时间。--debug 会增加一行更早的输出,显示是哪个来源
发现了该名称;默认关闭以保持输出整洁。EXPAND_ORG 仅列出候选同级域名,除非明确开启,
否则不会扫描它们:共同所有权的证据
并不等同于扫描授权。deep 模式如何避免引入无关域名这是一个刻意的设计约束:
core/resolver.py: is_wildcard_answer),而不仅仅是根区域:
即使根区域没有,*.dev.example.com 上的全匹配也会被捕获。/24(Scope.ptr_scan_targets),并且对于位于
CDN/云/共享托管 ASN 上的 IP 会完全跳过(Scope.is_shared_infra):
扫描 Cloudflare 的 /24 会返回数千个无关租户。Scope.accept_ptr_result):名称必须在范围内,并且
正向解析必须回到反向查找来源的同一 /24。仅凭
未确认的 PTR 记录不能证明任何事。sources (passive, no key) ┐
sources (active: brute, AXFR) ├→ candidates → resolver (wildcard-aware)
dns_extra (SPF/DMARC/SRV) ┘ │
▼
permutation round (dnsgen-style)
│
▼ (deep mode only)
TLS SAN · HTTP probe + crawl · PTR sweep (FCrDNS) · vhost
│
▼
SQLite (history/diff) + JSON/CSV/TXT export
subscout/core/:模型、范围/抗噪规则、解析器、
排列、DNS 记录解析、流水线编排器。subscout/sources/:可插拔的被动收集源。subscout/enrich/:深度模式关联:ASN、TLS、HTTP、爬取、PTR、
vhost、端口扫描、存储桶、NS/NSEC、GitHub 代码搜索。subscout/storage/:SQLite 历史/差异存储,以及 JSON/CSV/TXT
导出。subscout/runner.py:共享的扫描执行与结果打印
逻辑,供 CLI 和控制台共同使用。subscout/cli.py:一次性、由标志驱动的前端(Typer)。subscout/console.py:持久化的、msfconsole 风格的控制台。subscout/banner.py:启动横幅。core/models.py、core/scope.py、
core/permutations.py、core/dns_extra.py、storage/)已编写
并直接测试。需要
aiodns/httpx 的解析器/流水线测试已用 mock 编写(tests/test_resolver.py、
tests/test_pipeline.py),但仅做了语法检查
(py_compile),并未实际运行。在依赖此工具之前,请在具有正常
互联网访问的机器上运行
pip install -r requirements.txt && pytest,并对你控制的域名做一次测试扫描,以
确认通配符过滤和 PTR 门控行为符合预期。仅对你获授权测试的域名运行此工具。AXFR 尝试、暴力破解和 vhost 探测都会直接触及目标 的基础设施。