更友好的使用帮助

This commit is contained in:
shmilylty
2019-08-14 03:25:15 +08:00
parent 4428790766
commit 87749f1452
+48 -66
View File
@@ -119,7 +119,7 @@ OneForAll命令行界面基于[Fire](https://github.com/google/python-fire/)实
oneforall.py是主程序入口,oneforall.py里有调用aiobrute.py和dbexport.py,为了方便进行子域爆破和数据库导出独立出了aiobrute.py和dbexport.py,这两个文件可以单独运行,并且所接受参数要更丰富一点。 oneforall.py是主程序入口,oneforall.py里有调用aiobrute.py和dbexport.py,为了方便进行子域爆破和数据库导出独立出了aiobrute.py和dbexport.py,这两个文件可以单独运行,并且所接受参数要更丰富一点。
1. oneforall.py使用帮助 1. **oneforall.py使用帮助**
```bash ```bash
python oneforall.py --help python oneforall.py --help
@@ -132,40 +132,49 @@ oneforall.py是主程序入口,oneforall.py里有调用aiobrute.py和dbexport.
oneforall.py --target=TARGET <flags> oneforall.py --target=TARGET <flags>
DESCRIPTION DESCRIPTION
Version: 0.0.2 Version: 0.0.4
Project: https://github.com/shmilylty/OneForAll/ Project: https://git.io/fjHT1
Example: Example:
python oneforall.py --target example.com run python3 oneforall.py --target example.com run
python oneforall.py --target example.com --brute True --port medium --valid 1 run python3 oneforall.py --target ./domains.txt run
python oneforall.py --target ./domains.txt --format csv --path= ./result.csv --output True run python3 oneforall.py --target example.com --brute True run
python3 oneforall.py --target example.com --verify False run
python3 oneforall.py --target example.com --valid None run
python3 oneforall.py --target example.com --port medium run
python3 oneforall.py --target example.com --format csv run
python3 oneforall.py --target example.com --show True run
Note: Note:
参数valid可选值10None分别表示导出有效,无效,全部子域 参数valid可选值1,0,None分别表示导出有效,无效,全部子域
参数verify为True会尝试解析和请求子域并根据结果给子域有效性打上标签
参数port可选值有'small', 'medium', 'large', 'xlarge',详见config.py配置 参数port可选值有'small', 'medium', 'large', 'xlarge',详见config.py配置
参数format可选格式有'csv','tsv','json','yaml','html','xls','xlsx','dbf','latex','ods' 参数format可选格式有'csv', 'tsv', 'json', 'yaml', 'html', 'xls', 'xlsx',
'dbf', 'latex', 'ods'
参数path为None会根据format参数和域名名称在项目结果目录生成相应文件 参数path为None会根据format参数和域名名称在项目结果目录生成相应文件
ARGUMENTS ARGUMENTS
TARGET TARGET
单个域名或者每行一个域名的文件路径 单个域名或者每行一个域名的文件路径(必需参数)
FLAGS FLAGS
--brute=BRUTE --brute=BRUTE
是否使用爆破模块默认禁用) 使用爆破模块(默认False)
--verify=VERIFY
验证子域有效性(默认True)
--port=PORT --port=PORT
HTTP请求验证的端口范围默认medium 请求验证的端口范围(默认medium)
--valid=VALID --valid=VALID
导出子域的有效性默认1 导出子域的有效性(默认1)
--path=PATH --path=PATH
导出路径(默认None) 导出路径(默认None)
--format=FORMAT --format=FORMAT
导出格式默认xlsx 导出格式(默认xlsx)
--output=OUTPUT --show=SHOW
是否将导出数据输出到终端(默认False 终端显示导出数据(默认False)
``` ```
2. aiobrute.py使用帮助 2. **aiobrute.py使用帮助**
关于泛解析问题处理程序首先会访问一个随机的子域判断是否泛解析,如果使用了泛解析则是通过以下判断处理: 关于泛解析问题处理程序首先会访问一个随机的子域判断是否泛解析,如果使用了泛解析则是通过以下判断处理:
- 一是主要是与泛解析的IP集合和TTL值做对比,可以参考[这篇文章](http://sh3ll.me/archives/201704041222.txt)。 - 一是主要是与泛解析的IP集合和TTL值做对比,可以参考[这篇文章](http://sh3ll.me/archives/201704041222.txt)。
@@ -182,30 +191,35 @@ oneforall.py是主程序入口,oneforall.py里有调用aiobrute.py和dbexport.
aiobrute.py - OneForAll多进程多协程异步子域爆破模块 aiobrute.py - OneForAll多进程多协程异步子域爆破模块
SYNOPSIS SYNOPSIS
aiobrute.py COMMAND | --target=TARGET <flags> aiobrute.py --target=TARGET <flags>
DESCRIPTION DESCRIPTION
Example Example
python aiobrute.py --target example.com run python3 aiobrute.py --target example.com run
python aiobrute.py --target ./domains.txt run python3 aiobrute.py --target ./domains.txt run
python aiobrute.py --target example.com --processes 4 --coroutine 64 --wordlist data/subdomains.txt run python3 aiobrute.py --target example.com --process 4 --coroutine 64 run
python aiobrute.py --target example.com --recursive True --depth 2 --namelist data/next_subdomains.txt run python3 aiobrute.py --target example.com --wordlist subdomains.txt run
python aiobrute.py --target www.{fuzz}.example.com --fuzz True --rule [a-z][0-9] run python3 aiobrute.py --target example.com --recursive True --depth 2 run
python3 aiobrute.py --target m.{fuzz}.a.bz --fuzz True --rule [a-z] run
Note: Note:
参数segment的设置受CPU性能,网络带宽,运营商限制等问题影响,默认设置500个子域为任务组, 参数segment的设置受CPU性能,网络带宽,运营商限制等问题影响,默认设置500个子域为任务组,
当你觉得你的环境不受以上因素影响,当前爆破速度较慢,那么强烈建议根据字典大小调整大小: 当你觉得你的环境不受以上因素影响,当前爆破速度较慢,那么强烈建议根据字典大小调整大小:
十万字典建议设置为5000,百万字典设置为50000 十万字典建议设置为5000,百万字典设置为50000
参数valid可选值1,0,None,分别表示导出有效,无效,全部子域
参数format可选格式:'csv', 'tsv', 'json', 'yaml', 'html', 'xls', 'xlsx',
'dbf', 'latex', 'ods'
参数path为None会根据format参数和域名名称在项目结果目录生成相应文件
ARGUMENTS ARGUMENTS
TARGET TARGET
单个域名或者每行一个域名的文件路径 单个域名或者每行一个域名的文件路径
FLAGS FLAGS
--processes=PROCESSES --process=PROCESS
爆破的进程数(默认CPU核心数) 爆破的进程数(默认CPU核心数)
--coroutine=COROUTINE --coroutine=COROUTINE
每个爆破进程下的协程数(默认16) 每个爆破进程下的协程数(默认64)
--wordlist=WORDLIST --wordlist=WORDLIST
指定爆破所使用的字典路径(默认使用config.py配置) 指定爆破所使用的字典路径(默认使用config.py配置)
--segment=SEGMENT --segment=SEGMENT
@@ -217,55 +231,23 @@ oneforall.py是主程序入口,oneforall.py里有调用aiobrute.py和dbexport.
--namelist=NAMELIST --namelist=NAMELIST
指定递归爆破所使用的字典路径(默认使用config.py配置) 指定递归爆破所使用的字典路径(默认使用config.py配置)
--fuzz=FUZZ --fuzz=FUZZ
是否使用fuzz模式进行爆破(默认False,开启须指定fuzz正则规则) 是否使用fuzz模式进行爆破(默认False,开启须指定fuzz正则规则)
--rule=RULE --rule=RULE
fuzz模式使用的正则规则(默认使用config.py配置) fuzz模式使用的正则规则(默认使用config.py配置)
--export=EXPORT
``` 是否导出爆破结果(默认True)
3. dbexport.py使用帮助
```bash
python dbexport.py --help
```
```bash
NAME
dbexport.py - OneForAll数据库导出模块
SYNOPSIS
dbexport.py TABLE <flags>
DESCRIPTION
Example:
python dbexport.py --db result.db --table name --format csv --output False
python dbexport.py --db result.db --table name --format csv --path= ./result.csv
Note:
参数valid可选值1,0,None,分别表示导出有效,无效,全部子域
参数format可选格式:'csv', 'tsv', 'json', 'yaml', 'html', 'xls', 'xlsx', 'dbf', 'latex', 'ods'
参数path为None会根据format参数和域名名称在项目结果目录生成相应文件
POSITIONAL ARGUMENTS
TABLE
要导出的表
FLAGS
--db=DB
要导出的数据库路径(默认为results/result.sqlite3)
--valid=VALID --valid=VALID
导出子域的有效性(默认None) 导出子域的有效性(默认None)
--path=PATH
导出路径(默认None)
--format=FORMAT --format=FORMAT
导出格式(默认xlsx) 导出格式(默认xlsx)
--output=OUTPUT --path=PATH
是否将导出数据输出到终端(默认False) 导出路径(默认None)
--show=SHOW
NOTES 终端显示导出数据(默认False)
You can also use flags syntax for POSITIONAL ARGUMENTS
``` ```
3. 其他模块使用请参考[使用帮助](./docs/using_help.md)
## 👏主要框架 ## 👏主要框架
* [aiodns](https://github.com/saghul/aiodns) - 简单DNS异步解析库。 * [aiodns](https://github.com/saghul/aiodns) - 简单DNS异步解析库。