mirror of
https://github.com/jaywcjlove/reference.git
synced 2025-06-16 12:11:21 +08:00
feat: add mitmproxy.md #60
This commit is contained in:
jaywcjlove
255
docs/mitmproxy.md
Normal file
255
docs/mitmproxy.md
Normal file
@ -0,0 +1,255 @@
|
||||
Mitmproxy 备忘清单
|
||||
====
|
||||
|
||||
[Mitmproxy](https://mitmproxy.org/) 是一个免费开源的交互式 HTTPS 代理。这是 mitmproxy 的快速参考备忘单。
|
||||
|
||||
入门
|
||||
-----
|
||||
|
||||
### 使用
|
||||
<!--rehype:wrap-class=col-span-2-->
|
||||
|
||||
选项 | 范例 | 描述
|
||||
:--|--|--
|
||||
`-p` | mitmproxy -p 8001 | 在端口 `8001` 上启动代理
|
||||
`-m` | mitmproxy -p 8001 -m reverse:<http://127.0.0.1:4000> | `8001` 端口反向代理到4000端口
|
||||
`-w` | mitmproxy -p 8001 -w traffic.mitm | 流到达时流向文件
|
||||
`-r` | mitmproxy -r traffic.mitm | 从文件中读取流
|
||||
`-C` | mitmproxy -C traffic.mitm | 从保存的文件重放客户端请求
|
||||
`-S` | mitmproxy -S traffic.mitm | 从保存的文件重放服务器响应
|
||||
`-s` | mitmproxy -s myScript.py | 执行脚本
|
||||
`-h` | mitmproxy -h | `mitmproxy` 快速帮助
|
||||
|
||||
### 移动
|
||||
|
||||
```markdown
|
||||
k Ctrl b
|
||||
▲ ▲▲
|
||||
│ ││
|
||||
h ◀ ─── + ─── ▶ l ││ page
|
||||
│ ││
|
||||
▼ ▼▼
|
||||
j Ctrl f / Space
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`h`, `j`, `k` ,`l` | 左、下、上、右
|
||||
`Ctrl` `b` | 向上翻页
|
||||
`Space` / `Ctrl` `f` | 向下翻页
|
||||
`g` / `G` | 转到开头/结尾
|
||||
`Arrows` | 上下左右
|
||||
<!--rehype:className=shortcuts-->
|
||||
|
||||
### 安装
|
||||
<!--rehype:wrap-class=col-span-2-->
|
||||
|
||||
- [mitmproxy 文档](https://docs.mitmproxy.org/stable/) _(mitmproxy.org)_
|
||||
- [mitmproxy 开源仓库](https://github.com/mitmproxy/mitmproxy) _(github.com)_
|
||||
|
||||
---
|
||||
|
||||
```bash
|
||||
$ brew install mitmproxy # macOS
|
||||
```
|
||||
|
||||
### 流（视图）
|
||||
<!--rehype:wrap-class=row-span-2-->
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`A` | 恢复所有拦截的流
|
||||
`D` | 重复流
|
||||
`F` | 设置焦点跟随
|
||||
`L` | 从文件加载流
|
||||
`M` | 切换查看标记流
|
||||
`S` | 开始服务器回放
|
||||
`U` | 取消设置所有标记
|
||||
`V` | 还原对此流的更改
|
||||
`X` | 杀死这个流
|
||||
`Z` | 清除所有未显示的流
|
||||
`a` | 恢复此拦截流
|
||||
`b` | 将响应主体保存到文件
|
||||
`d` | 从视图中删除流
|
||||
`e` | 将此流导出到文件
|
||||
`f` | 设置视图过滤器
|
||||
`m` | 在此流程上切换标记
|
||||
`n` | 创建新流程
|
||||
`o` | 设置流列表顺序
|
||||
`r` | 重播此流程
|
||||
`v` | 反向流列表顺序
|
||||
`w` | 将列出的流程保存到文件
|
||||
`\|` | 在此流上运行脚本
|
||||
`Ctrl` `l` | 将剪辑发送到剪贴板
|
||||
<!--rehype:className=shortcuts-->
|
||||
|
||||
### 常见的快捷键
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`q` | 返回/退出
|
||||
`z` | 清除流列表
|
||||
`:` | 命令提示符
|
||||
`E` | 查看事件日志
|
||||
`O` | 查看选项
|
||||
`r` | 重播此流程
|
||||
`Tab` | 下一个
|
||||
`Enter` | 选择
|
||||
<!--rehype:className=shortcuts-->
|
||||
|
||||
### 全局键绑定
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`-` | 循环到下一个布局
|
||||
`?` | 查看帮助
|
||||
`B` | 启动附加的浏览器
|
||||
`C` | 查看命令
|
||||
`I` | 切换拦截
|
||||
`K` | 查看按键绑定
|
||||
`P` | 查看流程详细信息
|
||||
`Q` | 立即退出
|
||||
`W` | 流式传输到文件
|
||||
`i` | 设置拦截
|
||||
`Ctrl` `right` | 聚焦下一个布局窗格
|
||||
`Shift` `tab` | 聚焦下一个布局窗格
|
||||
<!--rehype:className=shortcuts-->
|
||||
|
||||
Mitmproxy 过滤器
|
||||
---------------
|
||||
|
||||
### 过滤器
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`f` | 设置视图过滤器 _(在流视图页面上)_
|
||||
<!--rehype:className=shortcuts-->
|
||||
|
||||
---
|
||||
|
||||
- [RegEX 备忘清单](./regex.md) _(jaywcjlove.github.io)_
|
||||
|
||||
正则表达式是 Python 风格的，可以指定为带引号的字符串
|
||||
|
||||
### 运算符
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`!` | 一元非
|
||||
`&` | 和
|
||||
`\|` | 或者
|
||||
`(...)` | 分组
|
||||
|
||||
### 表达式
|
||||
<!--rehype:wrap-class=row-span-2-->
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`~a` | 响应匹配资源：CSS、Javascript、Flash、图像。
|
||||
`~b` `regex` | 主体 Body
|
||||
`~bq` `regex` | 请求正文
|
||||
`~bs` `regex` | 响应体
|
||||
`~c` `int` | HTTP 响应代码
|
||||
`~d` `regex` | 域
|
||||
`~dst` `regex` | 匹配目标地址
|
||||
`~e` | 匹配错误
|
||||
`~h` `regex` | 标头
|
||||
`~hq` `regex` | 请求头
|
||||
`~hs` `regex` | 响应头
|
||||
`~http` | 匹配 HTTP 流
|
||||
`~m` `regex` | 方法
|
||||
`~marked` | 匹配标记流
|
||||
`~q` | 匹配请求无响应
|
||||
`~s` | 匹配响应
|
||||
`~src` `regex` | 匹配源地址
|
||||
`~t` `regex` | 内容类型标头
|
||||
`~tcp` | 匹配 TCP 流
|
||||
`~tq` `regex` | 请求 Content-Type 标头
|
||||
`~ts` `regex` | 响应内容类型标头
|
||||
`~u` `regex` | 网址
|
||||
`~websocket` | 匹配 WebSocket 流（和 HTTP-WebSocket 握手流）
|
||||
|
||||
### 流选择器
|
||||
|
||||
表达式
|
||||
|
||||
:---|---
|
||||
:---|---
|
||||
`@all` | 所有流程
|
||||
`@focus` | 目前关注的流程
|
||||
`@shown` | 当前显示的所有流程
|
||||
`@hidden` | 当前隐藏的所有流程
|
||||
`@marked` | 所有标记流
|
||||
`@unmarked` | 所有未标记的流
|
||||
|
||||
mitmproxy 有一组方便的流选择器，可以在当前视图上操作
|
||||
|
||||
### 示例
|
||||
|
||||
包含“google.com”的网址
|
||||
|
||||
```
|
||||
google\.com
|
||||
```
|
||||
|
||||
正文中包含字符串“test”的请求
|
||||
|
||||
```
|
||||
~q ~b test
|
||||
```
|
||||
|
||||
除了带有 text/html 内容类型的请求之外的任何内容：
|
||||
|
||||
```
|
||||
!(~q & ~t "text/html")
|
||||
```
|
||||
|
||||
替换请求中的整个 GET 字符串（需要引号才能使其工作）：
|
||||
|
||||
```
|
||||
":~q ~m GET:.*:/replacement.html"
|
||||
```
|
||||
|
||||
Mitmproxy 脚本
|
||||
-------
|
||||
<!--rehype:body-class=cols-2-->
|
||||
|
||||
### Custom response
|
||||
|
||||
```python
|
||||
from mitmproxy import http
|
||||
def request(flow: http.HTTPFlow) -> None:
|
||||
if flow.request.pretty_url == "http://example.com/path":
|
||||
flow.response = http.HTTPResponse.make(
|
||||
200, # (optional) status code
|
||||
b"Hello World", # (optional) content
|
||||
{"Content-Type": "text/html"} # (optional) headers
|
||||
)
|
||||
```
|
||||
|
||||
从代理发送回复而不向远程服务器发送任何数据
|
||||
|
||||
### Add header
|
||||
|
||||
```python
|
||||
class AddHeader:
|
||||
def __init__(self):
|
||||
self.num = 0
|
||||
def response(self, flow):
|
||||
self.num = self.num + 1
|
||||
flow.response.headers["count"] = str(self.num)
|
||||
addons = [
|
||||
AddHeader()
|
||||
]
|
||||
```
|
||||
|
||||
为每个响应添加一个 HTTP 标头
|
||||
|
||||
另见
|
||||
-------
|
||||
|
||||
- [mitmproxy addons](https://github.com/mitmproxy/mitmproxy/tree/master/examples/addons) _(github.com)_
|
||||
- [mitmproxy 文档](https://docs.mitmproxy.org/stable/) _(mitmproxy.org)_
|
||||
- [mitmproxy 开源仓库](https://github.com/mitmproxy/mitmproxy) _(github.com)_
|
||||
Reference in New Issue
Block a user