优秀的安全工具合集棱角社区出品
安全工具分享,如代码审计工具;安全评估工具;防火墙等(PS:仅作为安全研究,不得从事恶意活动!)。
-
添加时间:2023-02-17 18:43:00
标题:【 代理隧道 】go-mitmproxy - 用 Golang 实现的 mitmproxy,支持中间人攻击并解析、监测、篡改 HTTP/HTTPS 流量
项目地址/下载地址:https://github.com/lqqyt2423/go-mitmproxy
go-mitmproxy
go-mitmproxy是一个用 Golang 实现的 mitmproxy,支持中间人攻击(Man-in-the-middle)并解析、监测、篡改 HTTP/HTTPS 流量。主要功能
- 解析 HTTP/HTTPS 流量,可通过 WEB 界面查看流量详情。
- 支持插件机制,方便扩展自己需要的功能。多种事件 HOOK 可参考 examples。
- HTTPS 证书相关逻辑与 mitmproxy 兼容,并保存在
~/.mitmproxy文件夹中。如果之前已经用过mitmproxy并安装信任了根证书,则go-mitmproxy可以直接使用。 - 更多功能请参考配置文档。
暂未实现的功能
- 只支持客户端显示设置代理,不支持透明代理模式。
- 暂不支持 http/2 协议解析和 websocket 协议解析。
如需了解显示设置代理和透明代理模式的区别,请参考 Python 版本的 mitmproxy 文档:How mitmproxy works。
go-mitmproxy目前支持文中提到的『Explicit HTTP』和『Explicit HTTPS』。命令行工具
安装
go install github.com/lqqyt2423/go-mitmproxy/cmd/go-mitmproxy@latest使用
使用以下命令启动 go-mitmproxy 代理服务器:
go-mitmproxy启动后,HTTP 代理地址默认为 9080 端口,Web 界面默认在 9081 端口。
首次启动后需安装证书以解析 HTTPS 流量,证书会在首次启动命令后自动生成,路径为
~/.mitmproxy/mitmproxy-ca-cert.pem。安装步骤可参考 Python mitmproxy 文档:About Certificates。更多参数
可以使用以下命令查看 go-mitmproxy 的更多参数:
go-mitmproxy -hUsage of go-mitmproxy: -addr string 代理监听地址 (默认值为 ":9080") -allow_hosts []string HTTPS解析域名白名单 -cert_path string 生成证书文件路径 -debug int 调试模式:1-打印调试日志,2-显示调试来源 -f string 从文件名读取配置,传入json配置文件地址 -ignore_hosts value HTTPS解析域名黑名单 -ssl_insecure 不验证上游服务器的 SSL/TLS 证书 -version 显示 go-mitmproxy 版本 -web_addr string web 界面监听地址 (默认值为 ":9081")作为包引入开发功能
简单示例
package main import ( "log" "github.com/lqqyt2423/go-mitmproxy/proxy" ) func main() { opts := &proxy.Options{ Addr: ":9080", StreamLargeBodies: 1024 * 1024 * 5, } p, err := proxy.NewProxy(opts) if err != nil { log.Fatal(err) } log.Fatal(p.Start()) }通过开发插件添加功能
参考示例 examples,可通过自己实现
AddAddon方法添加自己实现的插件。下面列出目前支持的事件节点:
type Addon interface { // 一个客户端已经连接到了mitmproxy。请注意,一个连接可能对应多个HTTP请求。 ClientConnected(*ClientConn) // 一个客户端连接已关闭(由我们或客户端关闭)。 ClientDisconnected(*ClientConn) // mitmproxy 已连接到服务器。 ServerConnected(*ConnContext) // 服务器连接已关闭(由我们或服务器关闭)。 ServerDisconnected(*ConnContext) // 与服务器的TLS握手已成功完成。 TlsEstablishedServer(*ConnContext) // HTTP请求头已成功读取。此时,请求体为空。 Requestheaders(*Flow) // 完整的HTTP请求已被读取。 Request(*Flow) // HTTP响应头已成功读取。此时,响应体为空。 Responseheaders(*Flow) // 完整的HTTP响应已被读取。 Response(*Flow) // 流式请求体修改器 StreamRequestModifier(*Flow, io.Reader) io.Reader // 流式响应体修改器 StreamResponseModifier(*Flow, io.Reader) io.Reader }WEB 界面
你可以通过浏览器访问 http://localhost:9081/ 来使用 WEB 界面。
功能点
- 查看 HTTP/HTTPS 请求的详细信息
- 支持对 JSON 请求/响应进行格式化预览
- 支持二进制模式查看响应体
- 支持高级的筛选过滤规则
- 支持请求断点功能
License