用途:对给定域名做被动子域名枚举,尽量发现可公开获取的子域名,不进行主动爆破。
主要能力:
- query_crt_sh:调用 crt.sh API 查询证书透明度日志,接口为 GET https://crt.sh/?q=%25.{domain}&output=json,解析 name_value 字段并去重排序。
- search_engine_dorks:使用 site:.{domain} -www、site:{domain} inurl:subdomain、site:.*.{domain} 等 dork 查询,提取并验证子域名。
- check_common_subdomains:用内置常见子域名词表(如 api、app、dev、staging、admin、git、k8s 等)构造 FQDN 并做 DNS 解析,记录可解析项。
- passive_dns_lookup:可选,查询 VirusTotal、SecurityTrails(需 API key)或 DNSDumpster(免费有限)。
输出:结构化 JSON,含 total_subdomains、subdomains(fqdn、source、resolves、ip_addresses)、sources_queried、naming_patterns_detected 与 evidence。命名规律检测支持 {environment}-{service}、{service}.{environment}、{service}{number}、{geo}-{service} 等模式。
限制与注意:仅使用被动技术,不做主动爆破;需遵守速率限制(crt.sh 与搜索引擎约 10 次/分钟,DNS 解析约 30 次/分钟);部分数据源需 API key;失败时重试并保留部分结果,记录错误与查询日志。具体安装与调用方式资料未提供。