Mitmproxy 是一个免费开源的交互式 HTTPS 代理。这是 mitmproxy 的快速参考备忘单。
| 选项 | 范例 | 描述 |
|---|---|---|
-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 快速帮助 |
k Ctrl b
▲ ▲▲
│ ││
h ◀ ─── + ─── ▶ l ││ page
│ ││
▼ ▼▼
j Ctrl f / Space
| :--- | --- |
|---|---|
h, j, k ,l | 左、下、上、右 |
Ctrl b | 向上翻页 |
Space / Ctrl f | 向下翻页 |
g / G | 转到开头/结尾 |
Arrows | 上下左右 |
| :--- | --- |
|---|---|
A | 恢复所有拦截的流 |
D | 重复流 |
F | 设置焦点跟随 |
L | 从文件加载流 |
M | 切换查看标记流 |
S | 开始服务器回放 |
U | 取消设置所有标记 |
V | 还原对此流的更改 |
X | 杀死这个流 |
Z | 清除所有未显示的流 |
a | 恢复此拦截流 |
b | 将响应主体保存到文件 |
d | 从视图中删除流 |
e | 将此流导出到文件 |
f | 设置视图过滤器 |
m | 在此流程上切换标记 |
n | 创建新流程 |
o | 设置流列表顺序 |
r | 重播此流程 |
v | 反向流列表顺序 |
w | 将列出的流程保存到文件 |
| | 在此流上运行脚本 |
Ctrl l | 将剪辑发送到剪贴板 |
| :--- | --- |
|---|---|
q | 返回/退出 |
z | 清除流列表 |
: | 命令提示符 |
E | 查看事件日志 |
O | 查看选项 |
r | 重播此流程 |
Tab | 下一个 |
Enter | 选择 |
| :--- | --- |
|---|---|
- | 循环到下一个布局 |
? | 查看帮助 |
B | 启动附加的浏览器 |
C | 查看命令 |
I | 切换拦截 |
K | 查看按键绑定 |
P | 查看流程详细信息 |
Q | 立即退出 |
W | 流式传输到文件 |
i | 设置拦截 |
Ctrl right | 聚焦下一个布局窗格 |
Shift tab | 聚焦下一个布局窗格 |
| :--- | --- |
|---|---|
! | 一元非 |
& | 和 |
| | 或者 |
(...) | 分组 |
| :--- | --- |
|---|---|
~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"
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
)
从代理发送回复而不向远程服务器发送任何数据
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 标头