ProxyCat/README.md
2024-08-31 16:33:06 +08:00

238 lines
9.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

![ProxyCat](https://socialify.git.ci/honmashironeko/ProxyCat/image?description=1&descriptionEditable=%E4%B8%80%E6%AC%BE%E8%BD%BB%E9%87%8F%E7%BA%A7%E7%9A%84%E4%BC%98%E7%A7%80%E4%BB%A3%E7%90%86%E6%B1%A0%E4%B8%AD%E9%97%B4%E4%BB%B6%EF%BC%8C%E5%AE%9E%E7%8E%B0%E4%BB%A3%E7%90%86%E7%9A%84%E8%87%AA%E5%8A%A8%E8%BD%AE%E6%8D%A2&font=Bitter&forks=1&issues=1&language=1&logo=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F139044047%3Fv%3D4&name=1&owner=1&pattern=Circuit%20Board&pulls=1&stargazers=1&theme=Dark)
<p align="center">
<a href="/docs/readme_fr.md">Français</a>
·
<a href="/docs/readme_cn.md">简体中文</a>
·
<a href="/docs/readme_es.md">Español</a>
·
<a href="/docs/readme_de.md">Deutsch</a>
·
<a href="/docs/readme_ja.md">日本語</a>
·
<a href="/docs/readme_pt-BR.md">Português Brasileiro</a>
·
<a href="/docs/readme_it.md">Italiano</a>
·
<a href="/docs/readme_kr.md">한국어</a>
.
<a href="/docs/readme_nl.md">Nederlands</a>
.
<a href="/docs/readme_np.md">नेपाली</a>
.
<a href="/docs/readme_tr.md">Türkçe</a>
</p>
## 项目概述
渗透过程中总是遇到需要隐藏IP地址或者更换IP地址绕过安全设备的情况但是市面上的隧道代理价格极其昂贵普遍在20-40元/天这高昂的费用令人难以接受。但是笔者注意到短效IP其实性价比很高一个IP只需要几分钱平均只需要0.2-3元/天。
综上所述本工具应运而生目的是在于将持续时间仅有1分钟-60分钟不等的短效IP转变成一个固定IP供其他工具使用形成代理池服务器部署一次即可永久使用。
![项目原理图](./assets/202408260021207.png)
## 支持的功能
```
本地监听服务类:自定义监听端口、自定义监听端口身份鉴别
代理地址类4种协议支持、代理地址定时更换、代理地址每次请求后更换、API接口自动获取代理地址、支持有身份鉴别的代理地址
服务运行时支持仅在收到请求后才更换代理地址、支持超高并发、支持HTTP、HTTPS请求协议、支持每次启动检查版本更新
系统兼容性Windows、Linux、Mac原则上全支持、支持VPS远程部署、本地部署
```
## 项目使用
### 安装依赖
工具基于 Python 实现建议使用python3.8以上版本),在使用前请使用以下命令配置依赖:
```bash
pip install -r requirements.txt
# or 推荐使用国内源:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
```
使用 `python` 命令在项目目录运行 `python3 ProxyCat.py -h` 回显如下即配置成功:
```
# python3 ProxyCat.py -h
|\ _,,,---,,_ by 本间白猫
ZZZzz /,`.-'`' -. ;-;;,_
|,4- ) )-,_. ,\ ( `'-'
'---''(_/--' `-'\_) ProxyCat
用法: ProxyCat.py [-h] [-c]
参数:
-h, --help 显示此帮助信息并退出
-c C 指定配置文件名(默认config.ini)
```
### ip.txt 手动录入代理地址
按照该格式`socks5://127.0.0.1:7890` or` http://127.0.0.1:7890` 一行一个填入ip.txt文件中
```ip.txt
socks5://127.0.0.1:7890
socks4://127.0.0.1:7890
https://127.0.0.1:7890
http://127.0.0.1:7890
...
```
> 如果您缺少合适的国内代理地址,恰巧又有几块钱的话可以联系作者(微信公众号:樱花庄的本间白猫),获取多家低价代理购买地址,为作者带来几毛钱的推荐收益~
在config.ini(或自定义配置文件)中配置参数:
```
[SETTINGS]
# 本地服务器监听端口(默认为:1080)
port = 1080
# 代理地址轮换模式cycle 表示循环使用once 表示用完即止(默认为:cycle)
mode = cycle
# 代理地址更换时间(秒),设置为 0 时每次请求都更换 IP(默认为:300)
interval = 300
# 本地服务器端口认证用户名((默认为:neko)当为空时不需要认证
username = neko
# 本地服务器端口认证密码(默认为:123456)当为空时不需要认证
password = 123456
# 是否使用 getip 模块获取代理地址 True or False(默认为:False)
use_getip = False
# 代理地址列表文件(默认为:ip.txt)
proxy_file = ip.txt
```
配置对应参数后即可使用:
```bash
# python3 ProxyCat.py
```
**演示效果如下**
固定代理地址默认http://neko:123456@127.0.0.1:1080 or http://127.0.0.1:1080
如果您是部署在公网将127.0.0.1替换成您的公网IP即可。
![界面展示图](./assets/Clip_2024-08-29_10-15-56.png)
### 使用接口自动获取代理地址
工具支持直接调用代理地址获取的API接口当您配置`use_getip = True`时工具将不再从本地ip.txt中读取代理地址而是更换为通过执行 **getip.py** 脚本来获取新的代理地址。
此时,您需要将 **getip.py** 内容修改为您自己的接口,格式为 `IP:PORT`,默认为 `socks5` 协议,如果您要使用 `http` ,请手动更改。
**演示效果如下**
> 此处的运营商可在下方广告区域获取
![1724897980633](./assets/1724897980633.png)
## 性能表现
当前经过实际测试在代理地址服务器性能足够的情况下能够做到500并发不丢包基本可以覆盖大部分扫描和渗透测试。
![8e3f79309626ed0e653ba51b6482bff](./assets/8e3f79309626ed0e653ba51b6482bff.png)
## 免责申明
- 如果您下载、安装、使用、修改本工具及相关代码,即表明您信任本工具
- 在使用本工具时造成对您自己或他人任何形式的损失和伤害,我们不承担任何责任
- 如您在使用本工具的过程中存在任何非法行为,您需自行承担相应后果,我们将不承担任何法律及连带责任
- 请您务必审慎阅读、充分理解各条款内容,特别是免除或者限制责任的条款,并选择接受或不接受
- 除非您已阅读并接受本协议所有条款,否则您无权下载、安装或使用本工具
- 您的下载、安装、使用等行为即视为您已阅读并同意上述协议的约束
## 更新日志
**2024/08/31**
- 项目大结构调整
- 美化显示,将持续提示下一次更换代理地址的时间
- 已支持`ctrl+c`停止运行
- 大幅度调整为异步请求并发效率提升实测1000并发共5000包丢50包左右约99%稳定性500并发0丢包
- 不再采取运行时指定参数方案修改为从本地ini配置文件中读取易用性更高
- 支持本地无认证,适配更多软件代理方式
- 增加版本检测功能,将自动提示版本信息
- 增加代理服务器地址的身份鉴别功能但仅支持本地读取因大多数API都需要白名单因此不重复提供
- 增加功能仅在收到新请求的情况下才使用getip更新减少IP消耗
- 增加自识别代理服务器地址协议,以适配更多代理商
- 增加支持HTTPS、socks4代理协议目前已覆盖HTTP、HTTPS、socks5、socks4协议
**2024/08/25**
- 读取ip.txt时自动跳过空行
- httpx更换为并发池提高性能
- 增加缓冲字典,相同站点降低延迟
- 每次请求更换IP逻辑修改为随机选择代理
- 采用更加高效的结构和算法,优化请求处理逻辑
**2024/08/24**
- 采用异步方案提高并发能力和减少超时
- 重复代码封装提高代码复用性
**2024/08/23**
- 修改并发逻辑
- 增加身份鉴别功能
- 增加IP获取接口永久更换IP
- 增加每次请求更换IP功能
## 开发计划
- [x] 增加本地服务器身份鉴别功能,保证在公网使用过程中不被恶意盗用
- [x] 增加每次请求更换IP功能
- [x] 增加静态代理自动获取更新模块,从而永久运行
- [ ] 增加负载均衡模式,同时使用大量代理地址发送,从而有效提高并发效率,减少单一服务器负载
- [x] 增加版本检测功能
- [x] 增加代理地址身份鉴别支持
- [x] 增加功能仅在收到新请求的情况下才使用getip更新减少IP消耗
- [ ] 首次启动时批量对ip.txt中的代理服务器进行有效性检查
如果您有好的idea或者使用过程中遇到的bug都请辛苦您添加作者联系方式进行反馈
微信公众号:樱花庄的本间白猫
## 鸣谢
本排名不分先后,感谢为本项目提供帮助的师傅们。
[AabyssZG (曾哥)](https://github.com/AabyssZG)
[ProbiusOfficial (探姬)](https://github.com/ProbiusOfficial)
[![Star History Chart](https://api.star-history.com/svg?repos=honmashironeko/ProxyCat&type=Date)](https://star-history.com/#honmashironeko/ProxyCat&Date)
## 赞助开源
<<<<<<< HEAD
开源不易如果您觉得工具不错或许可以试着赞助一下作者的开发哦~
![ced79e6745867bd51b1eddfb17cb5702](./assets/202408260020820.png)
## 代理推荐
- [第一家便宜大碗代理购买用邀请码注册得5000免费IP+10元优惠券](https://h.shanchendaili.com/invite_reg.html?invite=fM6fVG)
=======
- 这几家先停止存在一定问题等修复协调好
>>>>>>> 54448867afb461da8b865a8b9328dce98853b467
- [各大运营商流量卡](https://172.lot-ml.com/ProductEn/Index/0b7c9adef5e9648f)