Subdominator健康检查与故障排除确保API密钥与数据源可用性【免费下载链接】SubdominatorSubDominator helps you discover subdomains associated with a target domain efficiently and with minimal impact for your Bug Bounty项目地址: https://gitcode.com/gh_mirrors/su/SubdominatorSubdominator是一款高效的子域名发现工具专为漏洞赏金猎人设计能帮助你以最小的影响发现目标域名相关的子域名。本文将详细介绍如何对Subdominator进行健康检查与故障排除确保API密钥与数据源的可用性让你的子域名枚举工作顺利进行。快速定位配置文件位置在进行健康检查前首先需要知道Subdominator的配置文件位置。Subdominator使用provider-config.yaml文件来存储API密钥和数据源配置。你可以通过以下命令快速查看当前使用的配置文件路径subdominator -scp默认情况下配置文件位于~/.config/subdominator/provider-config.yaml。如果你使用自定义配置路径可以通过-cp参数指定subdominator -cp /path/to/your/provider-config.yaml -d example.comAPI密钥配置与验证配置文件格式解析Subdominator支持两种配置格式确保你使用的是正确的格式扁平格式v2.1.x及以上arpsyndicate: [] bevigil: []嵌套格式早期v2版本Bevigil: api_key: value配置文件中每个条目都是一个列表你可以提供多个API密钥Subdominator会在每次运行时随机选择一个使用。常见API密钥配置示例以下是一些常见数据源的API密钥配置示例RapidAPI和WhoisXMLAPIrapidapi: [YOUR_RAPIDAPI_KEY] whoisxml: [YOUR_WHOISXMLAPI_KEY]DNSRepodnsrepo: [access_token:api_key]RedHuntLabsredhuntlabs: [endpoint_url:api_key]密钥验证方法要验证API密钥是否配置正确可以运行Subdominator并观察输出日志。如果某个数据源的API密钥无效你会在日志中看到类似以下的提示[Skipping dnsrepo: provider config pair is missing]数据源健康检查查看已集成的数据源Subdominator集成了73个被动OSINT数据源你可以在src/subdominator/resources/registry.py文件中查看完整的数据源列表。其中包括数字指纹类BinaryEdge、Shodan、Censys证书透明度类crtsh、CertSpotterDNS记录类DNSDumpster、RapidDns、DNSRepo搜索引擎类Google、Bing、Fofa数据源可用性检查要检查特定数据源是否可用可以使用Subdominator的调试模式运行并观察输出subdominator -d example.com -v在输出中你会看到每个数据源的枚举状态。例如成功的数据源枚举会显示类似以下的信息[INFO] Enumerating example.com at recursion depth 0 [INFO] Found 10 subdomains from crtsh而失败的数据源枚举则会显示错误信息如[ERROR] Failed to connect to Shodan API: API key invalid处理常见数据源问题Crt.sh数据源问题 Crt.sh数据源通过直接PostgreSQL连接查询公共证书透明度数据库。如果遇到连接问题请确保你的网络允许访问PostgreSQL端口5432。需要API密钥的数据源 对于需要API密钥的数据源如Bevigil、Shodan等如果未配置密钥Subdominator会自动跳过该数据源并在日志中显示提示信息。可选密钥数据源 部分数据源如Reconeer、SubMD支持可选密钥。没有密钥时可以使用但有密钥时能获得更丰富的结果。你可以在配置文件中为这些数据源添加密钥以提升性能。常见故障排除场景升级后配置文件问题从Subdominator v2升级到v3时如果存在v2生成的provider-config.yaml文件可能会导致崩溃。解决方法是删除旧的配置文件让Subdominator重新生成rm ~/.config/Subdominator/provider-config.yaml然后重新运行Subdominator它会生成新的配置文件你可以重新输入API密钥。数据源返回空结果如果某个数据源总是返回空结果可能是以下原因API密钥无效或权限不足检查你的API密钥是否正确以及是否具有足够的权限。数据源本身问题某些数据源可能有速率限制或临时故障。你可以稍后再试或查看数据源的官方状态页面。配置错误检查配置文件中是否正确设置了数据源的参数。例如DNSRepo需要access_token:api_key格式的字符串。Docker环境下的配置问题在Docker环境中使用Subdominator时需要确保配置文件正确挂载docker run --rm -v ~/.config/Subdominator:/config subdominator -cp /config/provider-config.yaml -d example.com如果遇到配置文件找不到的错误请检查挂载路径是否正确。使用输出报告进行健康诊断Subdominator会生成详细的输出报告其中包含每个数据源的子域名发现统计。你可以通过查看报告来了解各个数据源的表现在报告中你可以看到每个数据源发现的子域名数量这有助于你识别哪些数据源工作正常哪些可能存在问题。总结与最佳实践为了确保Subdominator始终处于最佳工作状态建议你定期检查配置文件确保API密钥有效特别是对于有有效期限制的密钥。关注版本更新Subdominator不断集成新的数据源并修复问题定期更新可以获得更好的性能和更多功能。多数据源配置配置多个同类数据源以提高子域名发现的覆盖率和可靠性。监控输出日志定期查看Subdominator的输出日志及时发现和解决数据源问题。通过遵循以上健康检查和故障排除步骤你可以确保Subdominator的API密钥和数据源始终保持可用从而更高效地进行子域名枚举工作。【免费下载链接】SubdominatorSubDominator helps you discover subdomains associated with a target domain efficiently and with minimal impact for your Bug Bounty项目地址: https://gitcode.com/gh_mirrors/su/Subdominator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考