Grasscutters/mitmproxy
3
0
Fork 0
mirror of https://github.com/Grasscutters/mitmproxy.git synced 2024-11-28 18:50:42 +00:00
Code Issues Projects Releases Wiki Activity

mode docs: add invocation examples

Browse Source
This commit is contained in:
Maximilian Hils 2021-05-14 11:03:33 +02:00
parent 3c4e47dd8c
commit 373609336a
1 changed files with 19 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/src/content/concepts-modes.md
View File

@ -46,6 +46,10 @@ connects to the target server.
## Transparent Proxy ## Transparent Proxy
```shell
mitmdump --mode transparent
```
In transparent mode, traffic is directed into a proxy at the network In transparent mode, traffic is directed into a proxy at the network
layer, without any client configuration required. This makes transparent layer, without any client configuration required. This makes transparent
proxying ideal for situations where you can't change client behaviour. proxying ideal for situations where you can't change client behaviour.
@ -62,7 +66,7 @@ that Network Address Translation should not be applied before the
traffic reaches mitmproxy, since this would remove the target traffic reaches mitmproxy, since this would remove the target
information, leaving mitmproxy unable to determine the real destination. information, leaving mitmproxy unable to determine the real destination.
{{< figure src="/schematics/proxy-modes-transparent-wrong.png" title="Modes Transparent Wrong" >}} {{< figure src="/schematics/proxy-modes-transparent-wrong.png" >}}
### Common Configurations ### Common Configurations
@ -135,6 +139,10 @@ most cases, the configuration will look like this:
## Reverse Proxy ## Reverse Proxy
```shell
mitmdump --mode reverse:https://example.com
```
mitmproxy is usually used with a client that uses the proxy to access mitmproxy is usually used with a client that uses the proxy to access
the Internet. Using reverse proxy mode, you can use mitmproxy to act the Internet. Using reverse proxy mode, you can use mitmproxy to act
like a normal HTTP server: like a normal HTTP server:
@ -195,6 +203,10 @@ through mitmproxy.
## Upstream Proxy ## Upstream Proxy
```shell
mitmdump --mode upstream:http://example.com:8081
```
If you want to chain proxies by adding mitmproxy in front of a different If you want to chain proxies by adding mitmproxy in front of a different
proxy appliance, you can use mitmproxy's upstream mode. In upstream proxy appliance, you can use mitmproxy's upstream mode. In upstream
mode, all requests are unconditionally transferred to an upstream proxy mode, all requests are unconditionally transferred to an upstream proxy
@ -209,4 +221,10 @@ tests).
## SOCKS Proxy ## SOCKS Proxy
```shell
mitmdump --mode socks5
```
In this mode, mitmproxy acts as a SOCKS5 proxy. In this mode, mitmproxy acts as a SOCKS5 proxy.
This is similar to the regular proxy mode, but using SOCKS5 instead of HTTP for connection establishment
with the proxy.