spray/README.md

80 lines
2.8 KiB
Markdown
Raw Normal View History

2022-09-26 17:19:08 +08:00
# SPRAY
下一代目录爆破工具. 一个完整的目录爆破解决方案
2022-12-09 19:30:42 +08:00
## Features
2023-01-04 14:19:32 +08:00
2022-12-09 19:30:42 +08:00
* 超强的性能, 在本地测试极限性能的场景下, 能超过ffuf与feroxbruster的性能50%以上. 实际情况受到网络的影响, 感受没有这么明确. 但在多目标下可以感受到明显的区别.
* 基于掩码的字典生成
* 基于规则的字典生成
* 动态智能过滤
2022-12-16 17:33:18 +08:00
* 全量gogo的指纹识别
* 自定义信息提取, 如ip,js, title, hash以及自定义的正则表达式
2022-12-09 19:30:42 +08:00
* 自定义过滤策略
* 自定义输出格式与内容
* *nix的命令行设计, 轻松与其他工具联动
* 多角度的自动被ban,被waf判断
* 断点续传
2023-01-04 14:19:32 +08:00
## QuickStart
2022-12-09 19:30:42 +08:00
2023-01-05 15:54:48 +08:00
[**Document**](https://chainreactors.github.io/wiki/spray/start)
2022-12-09 19:30:42 +08:00
基本使用, 从字典中读取目录进行爆破
`spray -u http://example.com -d wordlist1.txt -d wordlist2.txt`
通过掩码生成字典进行爆破
`spray -u http://example.com -w "/aaa/bbb{?l#4}/ccc"`
通过规则生成字典爆破. 规则文件格式参考hashcat的字典生成规则
`spray -u http://example.com -r rule.txt -d 1.txt`
2022-12-11 04:28:28 +08:00
批量爆破
`spray -l url.txt -r rule.txt -d 1.txt`
2022-12-12 17:28:55 +08:00
断点续传
2022-12-11 04:28:28 +08:00
2023-01-04 13:52:12 +08:00
`spray --resume stat.json`
2022-12-09 19:30:42 +08:00
2023-01-04 14:18:03 +08:00
## Wiki
2022-12-09 19:30:42 +08:00
2023-01-04 14:19:32 +08:00
详细用法请见[wiki](https://chainreactors.github.io/wiki/spray/)
2023-01-04 14:18:03 +08:00
https://chainreactors.github.io/wiki/spray/
2022-12-09 19:30:42 +08:00
2023-01-04 14:18:03 +08:00
## Make
2022-12-09 19:30:42 +08:00
2022-12-15 00:41:39 +08:00
```
2023-01-04 14:18:03 +08:00
git clone https://github.com/chainreactors/spray
cd spray
git clone https://github.com/chainreactors/gogo-templates templates
# 这里没用使用类似gogo的子模块的方式, 因为spray仅依赖其中的http指纹
2022-12-09 19:30:42 +08:00
2023-01-04 14:18:03 +08:00
go generate
2022-12-09 19:30:42 +08:00
2023-01-04 14:18:03 +08:00
go build .
2022-12-09 19:30:42 +08:00
```
2022-12-14 20:24:37 +08:00
2023-06-01 00:52:48 +08:00
## Similar or related works
* [ffuf](https://github.com/ffuf/ffuf) 一款优秀的http fuzz工具, 与spray的功能有一定重合但并不完全相同
* [feroxbuster](https://github.com/epi052/feroxbuster) 在编写spray之前我最常使用的目录爆破工具, 但因为批量扫描与过滤配置不便的原因选择自行编写
* [dirsearch](https://github.com/maurosoria/dirsearch) 较早的目录爆破工具, 参考了部分字典生成与配色
* [httpx](https://github.com/projectdiscovery/httpx) http信息收集功能, 参考了通过脚本语言编写任意过滤条件的功能
* [gobuster](https://github.com/OJ/gobuster) 一款统一是go编写的爆破工具, 但不仅限于目录爆破
2022-09-26 17:19:08 +08:00
## TODO
2023-01-04 13:52:12 +08:00
1. [x] 模糊对比
2022-12-12 17:28:55 +08:00
2. [x] 断点续传
2023-01-04 13:52:12 +08:00
3. [x] 简易爬虫
2022-12-12 17:07:07 +08:00
4. [ ] 支持http2
5. [ ] auto-tune, 自动调整并发数量
6. [x] 可自定义的递归配置
2023-01-06 03:31:28 +08:00
7. [x] 参考[fuzzuli](https://github.com/musana/fuzzuli), 实现备份文件字典生成器
8. [x] 参考[feroxbuster](https://github.com/epi052/feroxbuster)的`--collect-backups`, 自动爆破有效目录的备份
8. [ ] 支持socks/http代理, 不建议使用, 优先级较低. 代理的keep-alive会带来严重的性能下降
9. [ ] 云函数化, chainreactors工具链的通用分布式解决方案.