22
33## AutoRedTools
44
5- AutoRedTools是一款轻量级一站式自动下载/自动更新安全从业人员常用开源工具的工具,帮助安全从业者快速进行渗透工具的下载以及更新,节约大量环境安装和更新时间。
5+ AutoRedTools是一款轻量级一站式自动下载/自动更新常用开源软件的工具,主要帮助安全从业者/安全开发人员快速进行环境搭建以及常用软件的更新,节约软件的更新或者安
6+ 的时间,提升生产或工作效率。
67
78(注:本工具使用GitHub API能力,需要配置GitHub Token,未配置GitHub Token会被GitHub限制IP访问)
89
910## 前言
1011
1112- 本项目的开发者目前为个人开发者同时有自己的工作,新的功能或者需求会在闲暇时间进行开发,BUG会优先进行处理。
12- - 如果在使用中遇到问题或者有新的需求,请在提交BUG反馈,提交BUG前请先阅读最后的 "常见问题"。
13+ - 如果在使用中遇到问题或者有新的需求,请提交issus进行反馈,提交issus前请先阅读文后的 "常见问题"。
1314- 如果您觉得这个项目对您有用,请点击本项目右上角的"star"按钮。
1415- 如果您想持续跟进新的版本情况,请点击本项目右上角的"Watch"按钮。
15- - 如果您想参与本项目的开发,请点击本项目右上角的"Fork"按钮, 否则请勿点击"Fork"按钮。
16+ - 如果您想参与本项目的开发,请点击本项目右上角的"Fork"按钮, 否则请勿点击"Fork"按钮。
1617
1718## 免责声明
1819
1920请勿将本项目技术或代码应用在恶意软件制作、软件著作权/知识产权盗取或不当牟利等非法用途中。实施上述行为或利用本项目对非自己著作权所有的程序进行数据嗅探将涉嫌违反《中华人民共和国刑法》第二百一十七条、第二百八十六条,《中华人民共和国网络安全法》《中华人民共和国计算机软件保护条例》等法律规定。本项目提及的技术仅可用于私人学习测试等合法场景中,任何不当利用该技术所造成的刑事、民事责任均与本项目作者无关。
2021
2122## 适用场景
2223
24+ - 开发环境需要重装时
2325- 渗透测试环境重装时
2426- CTF比赛前需要环境安装时
2527- 攻防比赛时特定系统的环境安装
@@ -36,34 +38,24 @@ AutoRedTools是一款轻量级一站式自动下载/自动更新安全从业人
3638
3739``` bash
3840 git clone https://github.com/kelvinBen/AutoRedTools
41+ cd AutoRedTools
42+ python -m pip install -r requirements.txt
3943 python app.py -o ~ /Documents/tools
4044```
4145
4246### 参数说明(app.py)
4347
4448``` TXT
45- -o 指定工具安装路径
46- -p 指定代理,用于加速工具下载
47- -t 设置GitHub Token,未登录GitHub时,每小时只能请求60次,可能会导致部分工具下载失败,建议配置
48- ```
49-
50- ### 配置文件(config.py)
51-
52- ``` python
53- # 本工具基于GitHub API,未配置GitHub Token会被GitHub限制,导致部分软件下载失败
54- # 配置GitHub Token
55- # 配置方法:https://docs.github.com/cn/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
56- github_token= None
57-
58- # 配置代理, 由于某些原因GitHub访问速度较慢,配置代理用于加速GitHub的访问
59- proxy= None
49+ -o 指定需要安装的软件的目录,必填项
50+ -p 指定代理地址,用于加速GitHub下载效率,支持http/https/sockt5模式,配置全局代理可忽略
51+ -t 指定GitHub Token,未登录GitHub时,每小时只能请求60次,可能会导致部分工具下载失败,建议配置
6052```
6153
6254### 其他使用方法
6355
6456``` TXT
6557 1. 设置GitHub Token
66- python app.py -o ~/Documents/tools -t xxxxxxxxx
58+ python app.py -o ~/Documents/tools -t " xxxxxxxxx"
6759
6860 2. 使用http代理的方式启动
6961 python app.py -o ~/Documents/tools -p http://127.0.0.1:7890
@@ -73,6 +65,29 @@ AutoRedTools是一款轻量级一站式自动下载/自动更新安全从业人
7365
7466 4. 使用socks5代理的方式启动
7567 python app.py -o ~/Documents/tools -p socks5://127.0.0.1:7890
68+
69+ ```
70+
71+ ### 配置文件(~ /Documents/AutoRedTools/config.yml)
72+
73+ ``` yml
74+ # 请修改用户目录下的~/Documents/AuoRedTools/config.yml文件,修改脚本下的config.yml文件无效。
75+
76+ # AutoRedTools基于GitHub API,未配置github_token会被GitHub限制速率,会导致部分软件下载失败!!!
77+ # 注意:yaml配置文件要求,所有的“:”后面都需要跟随一个空格
78+ # 此配置文件优先级低于命令行配置
79+
80+ # 配置GitHub Token,如不设置请留空
81+ # 配置方法:https://docs.github.com/cn/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
82+ github_token :
83+
84+ # 配置三方代理, 由于某些原因GitHub访问速度较慢,配置代理用于加速GitHub的访问,如不设置请留空
85+ # 目前支持ghproxy/http/https/socks5
86+ # ghproxy配置方法: proxy: https://ghproxy.com/
87+ # http配置方法: proxy: http://127.0.0.1:7890/
88+ # https配置方法: proxy: https://127.0.0.1:7890/
89+ # socks5配置方法: proxy: socks5://127.0.0.1:7890/
90+ proxy :
7691` ` `
7792
7893## 已支持工具列表
@@ -124,7 +139,7 @@ AutoRedTools是一款轻量级一站式自动下载/自动更新安全从业人
124139- [x] AntSword
125140- [x] AntSword-Loader
126141
127- ## 自定义工具列表(tools.json)
142+ ## 自定义工具列表(~/Documents/AutoRedTools/ tools.json)
128143
129144tools.json 为常用开源软件的下载配置文件。
130145
@@ -177,11 +192,36 @@ platform: 为需要下载的系统平台,当type为source时需要为{}
177192
178193![ 效果展示] ( %E6%95%88%E6%9E%9C%E5%B1%95%E7%A4%BA.png )
179194
195+ ## 常见问题
196+
197+ ``` TXT
198+ 问题1: fatal: unable to access 'https://github.com/xxxxx': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443
199+ 解决:使用v2ray/ssr等代理工具的全局代理模式,或者使用-p参数添加代理或者修改~/Documents/AutoRedTools/config.yml文件中的proxy参数
200+
201+ 问题2:fatal: unable to access 'https://github.com/xxxxx': LibreSSL SSL_read: error:xxxxx:system library:func(4095):Operation timed out, errno 60
202+ 解决:使用v2ray/ssr等代理工具的全局代理模式,或者使用-p参数添加代理或者修改~/Documents/AutoRedTools/config.yml文件中的proxy参数
203+
204+ 问题3:error: RPC failed; curl 56 LibreSSL SSL_read: error:02FFF03C:system library:func(4095):Operation timed out, errno 60
205+ 解决:使用v2ray/ssr等代理工具的全局代理模式,或者使用-p参数添加代理或者修改~/Documents/AutoRedTools/config.yml文件中的proxy参数
206+
207+ 问题4:fatal: unable to access 'https://github.com/xxxxx': Could not resolve proxy: None
208+ 解决:
209+ 1. 编辑~/.gitconfig文件
210+ 2. 删除http.proxy,https.proxy,http.https://github.com.proxy,https.https://github.com.proxy相关的配置信息
211+ 3. 保存即可
212+
213+ 问题5:下载失败或者各种报错
214+ 解决: 开启全局代理模式解决各种错误
215+
216+ 问题6:其他问题
217+ 解决: 提交issus或者添加微信群进行问题反馈
218+ ```
219+
180220## 联系作者
181221
182222微信:bromomo (添加好友请备注:ART)
183223微信群:(如过期请通过以上方式添加微信)
184- ![ 加群] ( %E5%8A%A0%E7%BE%A4 .jpeg)
224+ ![ 加群] ( WechatIMG274 .jpeg)
185225
186226需求提交、BUG反馈、软件新增、分类建议均可添加好友或者入群交流。
187227
0 commit comments