fix: mitmproxy format

Fixed the modifier spacing
This commit is contained in:
FireIsGood committed 2024-05-22 01:30:43 -07:00
1 parent 3afa993ec1
commit a1432fc28c
1 file changed
+79 -87
+79 -87
View File
@@ -3,24 +3,24 @@ title: Mitmproxy
date: 2020-12-22 20:10:08
background: bg-[#d86138]
tags:
- capture
- traffic
- network
- utility
- capture
- traffic
- network
- utility
categories:
- Toolkit
- Toolkit
intro: |
[mitmproxy](https://mitmproxy.org/) is a free and open source interactive HTTPS proxy. This is a quick reference cheat sheet to the mitmproxy.
[mitmproxy](https://mitmproxy.org/) is a free and open source interactive HTTPS proxy. This is a quick reference cheat sheet to the mitmproxy.
plugins:
- copyCode
- copyCode
---
Getting Started
---------------
## Getting Started
### Usage {.col-span-2}
| Option | Example | Description |
|--------|----------------------------------------------------|-------------------------------------------|
| ------ | -------------------------------------------------- | ----------------------------------------- |
| `-p` | mitmproxy -p 8001 | Start proxy on port 8001 |
| `-m` | mitmproxy -p 8001 -m reverse:http://127.0.0.1:4000 | Reverse proxy on port 8001 to port 4000 |
| `-w` | mitmproxy -p 8001 -w traffic.mitm | Stream flows to file as they arrive |
@@ -30,79 +30,82 @@ Getting Started
| `-s` | mitmproxy -s myScript.py | Execute a script |
| `-h` | mitmproxy -h | mitmproxy quick help |
### Movement
### Movement
```markdown
```
k Ctrl b
▲ ▲▲
│ ││
h ◀ ─── + ─── ▶ l ││ page
│ ││
▼ ▼▼
j Ctrl f / Space
j Ctrl f / Space
```
---
| - | - |
|----------------------|-----------------------|
| -------------------- | --------------------- |
| `h`, `j`, `k` ,`l` | Left, Down, Up, Right |
| `Ctrl` `b` | Page up |
| `Space` / `Ctrl` `f` | Page down |
| `g` / `G` | Go to beginning / end |
| `Arrows` | Up, Down, Left, Right |
{.shortcuts}
### Copy to Clipboard
Command Syntax:
```
:export.clip format flow
```
----------------
---
Example:
| Description | Command Example |
|--------------------------------|------------------------------------|
| ------------------------------ | ---------------------------------- |
| 1. Copy as a curl command | `:export.clip curl @focus` |
| 2. Copy as a httpie | `:export.clip httpie @focus` |
| 2. Copy as a raw | `:export.clip raw @focus` |
| 2. Copy as a raw HTTP request | `:export.clip raw_request @focus` |
| 2. Copy as a raw HTTP response | `:export.clip raw_response @focus` |
{.style-list}
Export a flow to the system clipboard.
### Save to File
Command Syntax:
```
:export.file format flow path
```
----------------
---
Example:
| Description | Command Example |
|------------------------------|----------------------------------------------------|
| ---------------------------- | -------------------------------------------------- |
| 1. Export to /tmp/a.curl | `:export.file curl @focus /tmp/a.curl` |
| 2. Export to /tmp/a.httpie | `:export.file httpie @focus /tmp/a.httpie` |
| 2. Export to /tmp/a.raw | `:export.file raw @focus /tmp/a.raw` |
| 2. Export to /tmp/a.request | `:export.file raw_request @focus /tmp/a.request` |
| 2. Export to /tmp/a.response | `:export.file raw_response @focus /tmp/a.response` |
{.style-list}
Export a flow to the system clipboard.
### Common Keybindings
| - | - |
|---------|------------------|
| ------- | ---------------- |
| `q` | Back / Exit |
| `z` | Clear flow list |
| `:` | Command prompt |
@@ -111,13 +114,13 @@ Export a flow to the system clipboard.
| `r` | Replay this flow |
| `Tab` | Next |
| `Enter` | Select |
{.shortcuts}
### Global Keybindings
| - | - |
|----------------|---------------------------|
| -------------- | ------------------------- |
| `-` | Cycle to next layout |
| `?` | View help |
| `B` | Start an attached browser |
@@ -130,52 +133,47 @@ Export a flow to the system clipboard.
| `i` | Set intercept |
| `Ctrl` `right` | Focus next layout pane |
| `Shift` `tab` | Focus next layout pane |
{.shortcuts}
### Flow (View)
| - | - |
|------------|------------------------------|
| `A` | Resume all intercepted flows |
| `D` | Duplicate flow |
| `F` | Set focus follow |
| `L` | Load flows from file |
| `M` | Toggle viewing marked flows |
| `S` | Start server replay |
| `U` | Un-set all marks |
| `V` | Revert changes to this flow |
| `X` | Kill this flow |
| `Z` | Purge all flows not showing |
| `a` | Resume this intercepted flow |
| `b` | Save response body to file |
| `d` | Delete flow from view |
| `e` | Export this flow to file |
| `f` | Set view filter |
| `m` | Toggle mark on this flow |
| `n` | Create a new flow |
| `o` | Set flow list order |
| `r` | Replay this flow |
| `v` | Reverse flow list order |
| `w` | Save listed flows to file |
| `|` | Run a script on this flow |
| `Ctrl` `l` | Send cuts to clipboard |
| - | - |
| --------------- | ---------------------------- |
| `A` | Resume all intercepted flows |
| `D` | Duplicate flow |
| `F` | Set focus follow |
| `L` | Load flows from file |
| `M` | Toggle viewing marked flows |
| `S` | Start server replay |
| `U` | Un-set all marks |
| `V` | Revert changes to this flow |
| `X` | Kill this flow |
| `Z` | Purge all flows not showing |
| `a` | Resume this intercepted flow |
| `b` | Save response body to file |
| `d` | Delete flow from view |
| `e` | Export this flow to file |
| `f` | Set view filter |
| `m` | Toggle mark on this flow |
| `n` | Create a new flow |
| `o` | Set flow list order |
| `r` | Replay this flow |
| `v` | Reverse flow list order |
| `w` | Save listed flows to file |
| <code>\|</code> | Run a script on this flow |
| `Ctrl` `l` | Send cuts to clipboard |
{.shortcuts}
Mitmproxy Filter
---------------
## Mitmproxy Filter
### Filter
| - | - |
|-----|---------------------------------------|
| --- | ------------------------------------- |
| `f` | Set view filter _(on flow view page)_ |
{.shortcuts}
---
@@ -184,22 +182,19 @@ Mitmproxy Filter
The regex are Python-style, it can be specified as quoted strings
### Operators
| - | - |
|---------|-----------|
| ------- | --------- | --- |
| `!` | unary not |
| `&` | and |
| `|` | or |
| ` | ` | or |
| `(...)` | grouping |
### Expressions {.row-span-2}
| - | - |
|----------------|------------------------------------------------------------|
| -------------- | ---------------------------------------------------------- |
| `~a` | Match asset in response: CSS, Javascript, Flash, images. |
| `~b` `regex` | Body |
| `~bq` `regex` | Request body |
@@ -225,9 +220,11 @@ The regex are Python-style, it can be specified as quoted strings
| `~websocket` | Match WebSocket flows (and HTTP-WebSocket handshake flows) |
### Flow selectors
Expressions
| - | - |
|-------------|----------------------------|
| ----------- | -------------------------- |
| `@all ` | All flows |
| `@focus ` | The currently focused flow |
| `@shown ` | All flows currently shown |
@@ -237,9 +234,8 @@ Expressions
mitmproxy has a set of convenient flow selectors that operate on the current view
### Examples
URL containing "google.com"
```
@@ -247,28 +243,24 @@ google\.com
```
Requests whose body contains the string "test"
```
~q ~b test
```
Anything but requests with a text/html content type:
```
!(~q & ~t "text/html")
```
Replace entire GET string in a request (quotes required to make it work):
```
":~q ~m GET:.*:/replacement.html"
```
Mitmproxy Scripts {.cols-2}
-------
## Mitmproxy Scripts {.cols-2}
### Custom response
@@ -284,10 +276,9 @@ def request(flow: http.HTTPFlow) -> None:
{"Content-Type": "text/html"} # (optional) headers
)
```
Send a reply from the proxy without sending any data to the remote server
### Add header
```python
@@ -304,9 +295,10 @@ addons = [
AddHeader()
]
```
Add an HTTP header to each response
Also see
-------
## Also see
- [mitmproxy addons](https://github.com/mitmproxy/mitmproxy/tree/master/examples/addons) _(github.com)_
- [mitmproxy docs](https://docs.mitmproxy.org/) _(mitmproxy.org)_