diff --git a/README.md b/README.md
index 6ec20b1..68bd07b 100644
--- a/README.md
+++ b/README.md
@@ -32,14 +32,14 @@
| 序号 | 项目名称 | 项目简介 | Star |
|----|-----------|--------------------------|----|
-|1|[**HackBrowserData**](detail/HackBrowserData.md)|hack-browser-data 是一个解密浏览器数据(密码/历史记录/Cookies/书签)的导出工具,支持全平台主流浏览器的数据导出窃取。|4095|
-|2|[**fscan**](detail/fscan.md)|一款内网综合扫描工具,方便一键自动化、全方位漏扫扫描。支持主机存活探测、端口扫描、常见服务的爆破、ms17010、redis批量写公钥、计划任务反弹shell、读取win网卡信息、web指纹识别、web漏洞扫描、netbios探测、域控识别等功能。|2974|
-|3|[**pocsuite3**](detail/pocsuite3.md)|pocsuite3是由Knownsec 404团队开发的开源远程漏洞测试和概念验证开发框架。它带有强大的概念验证引擎,以及针对最终渗透测试人员和安全研究人员的许多强大功能。|2300|
+|1|[**HackBrowserData**](detail/HackBrowserData.md)|hack-browser-data 是一个解密浏览器数据(密码/历史记录/Cookies/书签)的导出工具,支持全平台主流浏览器的数据导出窃取。|4151|
+|2|[**fscan**](detail/fscan.md)|一款内网综合扫描工具,方便一键自动化、全方位漏扫扫描。支持主机存活探测、端口扫描、常见服务的爆破、ms17010、redis批量写公钥、计划任务反弹shell、读取win网卡信息、web指纹识别、web漏洞扫描、netbios探测、域控识别等功能。|2996|
+|3|[**pocsuite3**](detail/pocsuite3.md)|pocsuite3是由Knownsec 404团队开发的开源远程漏洞测试和概念验证开发框架。它带有强大的概念验证引擎,以及针对最终渗透测试人员和安全研究人员的许多强大功能。|2312|
|4|[**CDK**](detail/CDK.md)|CDK是一款为容器环境定制的渗透测试工具,在已攻陷的容器内部提供零依赖的常用命令及PoC/EXP。集成Docker/K8s场景特有的逃逸、横向移动、持久化利用方式,插件化管理。|2036|
-|5|[**Viper**](detail/Viper.md)|VIPER是一款图形化内网渗透工具,将内网渗透过程中常用的战术及技术进行模块化及武器化。|2010|
+|5|[**Viper**](detail/Viper.md)|VIPER是一款图形化内网渗透工具,将内网渗透过程中常用的战术及技术进行模块化及武器化。|2023|
|6|[**Kunpeng**](detail/Kunpeng.md)|Kunpeng是一个Golang编写的开源POC检测框架,集成了包括数据库、中间件、web组件、cms等等的漏洞POC,可检测弱口令、SQL注入、XSS、RCE等漏洞类型,以动态链接库的形式提供调用,通过此项目可快速开发漏洞检测类的系统,比攻击者快一步发现风险漏洞。|1422|
-|7|[**KunLun-M**](detail/KunLun-M.md)|KunLun-M是一个完全开源的静态白盒扫描工具,支持PHP、JavaScript的语义扫描,基础安全、组件安全扫描,Chrome Ext\Solidity的基础扫描。|1363|
-|8|[**antSword**](detail/antSword.md)|中国蚁剑是一款开源的跨平台网站管理工具。|1341|
+|7|[**KunLun-M**](detail/KunLun-M.md)|KunLun-M是一个完全开源的静态白盒扫描工具,支持PHP、JavaScript的语义扫描,基础安全、组件安全扫描,Chrome Ext\Solidity的基础扫描。|1374|
+|8|[**antSword**](detail/antSword.md)|中国蚁剑是一款开源的跨平台网站管理工具。|1353|
|9|[**Stowaway**](detail/Stowaway.md)|Stowaway 是一款多级代理工具,可将外部流量通过多个节点代理至内网,突破内网访问限制。Stowaway 可以方便渗透测试人员通过多级跳跃,从外部dmz等一系列区域逐步深入核心网络;Stowaway 除了流量转发功能,还提供了端口复用、ssh隧道,流量伪装等专为渗透测试人员所用的功能。|1168|
|10|[**shellcodeloader**](detail/shellcodeloader.md)|Windows平台的shellcode免杀加载器,自带多种加载方式:32位自带13种加载方式,64位自带12种加载方式。|1146|
@@ -77,8 +77,8 @@
| 序号 | 项目名称 | 作者 | 项目简介 | Star |
|------|----------|------|----------|------|
-|1|[**OpenStar**](detail/OpenStar.md)|starjun|OpenStar 是一个基于 OpenResty 的高性能 Web 应用防火墙,支持复杂规则编写。提供了常规的 HTTP 字段规则配置,还提供了 IP 黑白名单、访问频次等配置,对于 CC 防护更提供的特定的规则算法,并且支持搭建集群进行防护。|1030|
-|2|[**linglong**](detail/linglong.md)|awake1t|linglong是一款甲方资产巡航扫描系统。系统定位是发现资产,进行端口爆破。帮助企业更快发现弱口令问题。主要功能包括: 资产探测、端口爆破、定时任务、管理后台识别、报表展示。|939|
+|1|[**OpenStar**](detail/OpenStar.md)|starjun|OpenStar 是一个基于 OpenResty 的高性能 Web 应用防火墙,支持复杂规则编写。提供了常规的 HTTP 字段规则配置,还提供了 IP 黑白名单、访问频次等配置,对于 CC 防护更提供的特定的规则算法,并且支持搭建集群进行防护。|1040|
+|2|[**linglong**](detail/linglong.md)|awake1t|linglong是一款甲方资产巡航扫描系统。系统定位是发现资产,进行端口爆破。帮助企业更快发现弱口令问题。主要功能包括: 资产探测、端口爆破、定时任务、管理后台识别、报表展示。|954|
|3|[**GShark**](detail/gshark.md)|madneal|一款开源敏感信息监测系统,可以监测包括 github、gitlab(目前不太稳定,由于gitlab对于免费用户不提供代码全文检索API)、searchcode 多平台的敏感信息监测。|443|
|4|[**Juggler**](detail/Juggler.md)|C4o|一个也许能骗到黑客的系统,可以作为WAF等防护体系的一环。|390|
@@ -91,7 +91,7 @@
|3|[**Kunyu**](detail/Kunyu.md)|风起|Kunyu(坤舆),是一款基于ZoomEye API开发的信息收集工具,旨在让企业资产收集更高效,使更多安全相关从业者了解、使用网络空间测绘技术。|565|
|4|[**Glass**](detail/Glass.md)|s7ckTeam|Glass是一款针对资产列表的快速指纹识别工具,通过调用Fofa/ZoomEye/Shodan/360等api接口快速查询资产信息并识别重点资产的指纹,也可针对IP/IP段或资产列表进行快速的指纹识别。|556|
|5|[**ZoomEye-Python**](detail/ZoomEye-Python.md)|Knownsec404|ZoomEye-python 是一款基于 ZoomEye API 开发的 Python 库,提供了 ZoomEye 命令行模式,同时也可以作为 SDK 集成到其他工具中。该库可以让技术人员更便捷地搜索、筛选、导出 ZoomEye 的数据|331|
-|6|[**ksubdomain**](detail/ksubdomain.md)|w8ay|ksubdomain是一款基于无状态子域名爆破工具,支持在Windows/Linux/Mac上使用,它会很快的进行DNS爆破,在Mac和Windows上理论最大发包速度在30w/s,linux上为160w/s的速度。|122|
+|6|[**ksubdomain**](detail/ksubdomain.md)|w8ay|ksubdomain是一款基于无状态子域名爆破工具,支持在Windows/Linux/Mac上使用,它会很快的进行DNS爆破,在Mac和Windows上理论最大发包速度在30w/s,linux上为160w/s的速度。|155|
|7|[**ct**](detail/ct.md)|rungobier@Knownsec404|ct 是一款使用 rust 语言进行开发,并且基于ZoomEye域名查询以及利用域名字典进行子域名爆破的工具,同时在最终爆破完成后可使用脚本,将相应的的.gv 文件转化成为相应的 .png 文件进行可视化展示|61|
|8|[**Zoomeye-Tools**](detail/ZoomEye-Tools.md)|Knownsec404|一个配合ZoomEye使用的Chrome插件,可以查看当前网页所在ip信息或跳转查看详细信息,还可以根据关键词一键跳转至ZoomEye进行搜索|31|
|9|[**ZoomEye-go**](detail/ZoomEye-go.md)|gyyyy|ZoomEye-go 是一款基于 ZoomEye API 开发的 Golang 库,提供了 ZoomEye 命令行模式,同时也可以作为SDK集成到其他工具中。该库可以让技术人员更便捷地搜索、筛选、导出 ZoomEye 的数据。|27|
diff --git a/detail/ksubdomain.md b/detail/ksubdomain.md
index 541e8de..1dd78e8 100644
--- a/detail/ksubdomain.md
+++ b/detail/ksubdomain.md
@@ -8,14 +8,24 @@
-ksubdomain是一款基于无状态的子域名爆破工具,类似无状态端口扫描,支持在Windows/Linux/Mac上进行快速的DNS爆破,在Mac和Windows上理论最大发包速度在30w/s,linux上为160w/s。
+ksubdomain是一款基于无状态的子域名爆破工具,类似无状态端口扫描,支持在Windows/Linux/Mac上进行快速的DNS爆破,拥有重发机制不用担心漏包。
hacking8信息流的src资产收集 https://i.hacking8.com/src/ 用的是ksubdomain
+![](https://github.com/boy-hack/ksubdomain/raw/main/image.gif)
+## 安装
+1. 下载二进制 https://github.com/boy-hack/ksubdomain/releases
+2. 安装libpcap环境
+ - Windows
+ 下载`winpcap`驱动:https://www.winpcap.org/install/default.htm
+ - Linux
+ 已经静态编译打包libpcap,无需其他操作
+ - MacOS
+ 自带libpcap,无需其他操作
+3. 执行!
+
## Useage
```bash
-w8ay@MacBook-Pro ~/programs/ksubdomain main ● ./ksubdomain
-
NAME:
KSubdomain - 无状态子域名爆破工具
@@ -38,23 +48,106 @@ GLOBAL OPTIONS:
```
### 模式
+
**验证模式**
+提供完整的域名列表,ksubdomain负责快速获取结果
+
+```bash
+./ksubdomain verify -h
+
+NAME:
+ cmd verify - 验证模式
+
+USAGE:
+ cmd verify [command options] [arguments...]
+
+OPTIONS:
+ --filename value, -f value 验证域名文件路径
+ --band value, -b value 宽带的下行速度,可以5M,5K,5G (default: "2m")
+ --resolvers value, -r value dns服务器文件路径,一行一个dns地址
+ --output value, -o value 输出文件名
+ --silent 使用后屏幕将仅输出域名 (default: false)
+ --retry value 重试次数,当为-1时将一直重试 (default: 3)
+ --timeout value 超时时间 (default: 6)
+ --stdin 接受stdin输入 (default: false)
+ --only-domain, --od 只打印域名,不显示ip (default: false)
+ --not-print, --np 不打印域名结果 (default: false)
+ --help, -h show help (default: false)
+```
-提供完整的域名列表,ksubdomain负责快速从dns服务器获取结果
```
+从文件读取
./ksubdomain v -f dict.txt
-或
+
+从stdin读取
echo "www.hacking8.com"|./ksubdomain v --stdin
```
-**枚举模式**
+**枚举模式**
只提供一级域名,指定域名字典或使用ksubdomain内置字典,枚举所有二级域名
+
+```bash
+./ksubdomain enum -h
+
+NAME:
+ cmd enum - 枚举域名
+
+USAGE:
+ cmd enum [command options] [arguments...]
+
+OPTIONS:
+ --band value, -b value 宽带的下行速度,可以5M,5K,5G (default: "2m")
+ --resolvers value, -r value dns服务器文件路径,一行一个dns地址
+ --output value, -o value 输出文件名
+ --silent 使用后屏幕将仅输出域名 (default: false)
+ --retry value 重试次数,当为-1时将一直重试 (default: 3)
+ --timeout value 超时时间 (default: 6)
+ --stdin 接受stdin输入 (default: false)
+ --only-domain, --od 只打印域名,不显示ip (default: false)
+ --not-print, --np 不打印域名结果 (default: false)
+ --domain value, -d value 爆破的域名
+ --domainList value, --dl value 从文件中指定域名
+ --filename value, -f value 字典路径
+ --skip-wild 跳过泛解析域名 (default: false)
+ --level value, -l value 枚举几级域名,默认为2,二级域名 (default: 2)
+ --level-dict value, --ld value 枚举多级域名的字典文件,当level大于2时候使用,不填则会默认
+ --help, -h show help (default: false)
+```
+
```
-./ksubdomain e -f dict.txt
-或
+./ksubdomain e -d baidu.com
+
+从stdin获取
echo "baidu.com"|./ksubdomain e --stdin
```
+## 特性和Tips
+
+- 无状态爆破,有失败重发机制,速度极快
+- 中文帮助,-h会看到中文帮助
+- 两种模式,枚举模式和验证模式,枚举模式内置10w字典
+- 将网络参数简化为了-b参数,输入你的网络下载速度如-b 5m,将会自动限制网卡发包速度。
+- 可以使用./ksubdomain test来测试本地最大发包数
+- 获取网卡改为了全自动并可以根据配置文件读取。
+- 会有一个时时的进度条,依次显示成功/发送/队列/接收/失败/耗时 信息。
+- 不同规模的数据,调整 --retry --timeout参数即可获得最优效果
+- 当--retry为-1,将会一直重试直到所有成功。
+
+## 与massdns、dnsx对比
+
+使用100w字典,在4H5M的网络环境下测试
+
+| | ksubdomain | massdns | dnsx |
+| -------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| 支持系统 | Windows/Linux/Darwin | Windows/Linux/Darwin | Windows/Linux/Darwin |
+| 功能 | 支持验证和枚举 | 只能验证 | 只能验证 |
+| 发包方式 | pcap网卡发包 | epoll,pcap,socket | socket |
+| 命令行 | time ./ksubdomain v -b 5m -f d2.txt -o ksubdomain.txt -r dns.txt --retry 3 --np | time ./massdns -r dns.txt -t AAAA -w massdns.txt d2.txt --root -o L | time ./dnsx -a -o dnsx.txt -r dns.txt -l d2.txt -retry 3 -t 5000 |
+| 备注 | 加了--np 防止打印过多 | | |
+| 结果 | 耗时:1m28.273s
成功个数:1397 | 耗时:3m29.337s
成功个数:1396 | 耗时:5m26.780s
成功个数:1396 |
+
+ksubdomain只需要1分半,速度远远比massdns、dnsx快~
+
## 项目相关