The mitmproxy project’s tools are a set of front-ends that expose common underlying functionality.

mitmproxy is an interactive man-in-the-middle proxy for HTTP and HTTPS with a console interface.

mitmdump is the command-line version of mitmproxy. Think tcpdump for HTTP.

mitmweb is a web-based interface for mitmproxy.

Documentation, tutorials and distribution packages can be found on the mitmproxy website.

• Intercept HTTP & HTTPS requests and responses and modify them on the fly

• Save complete HTTP conversations for later replay and analysis

• Replay the client-side of an HTTP conversations

• Replay HTTP responses of a previously recorded server

• Reverse proxy mode to forward traffic to a specified server

• Transparent proxy mode on OSX and Linux

• Make scripted changes to HTTP traffic using Python

• SSL/TLS certificates for interception are generated on the fly

• And much, much more…

https://mitmproxy.org/

https://docs.mitmproxy.org/stable/
https://docs.mitmproxy.org/stable/concepts-options/
https://docs.mitmproxy.org/stable/concepts-modes/

mitmdump Manual pages:

user@host:~$ man mitmdump

mitmproxy Manual pages:

user@host:~$ man mitmproxy

mitmweb Manual pages:

user@host:~$ man mitmweb

Command line help:

user@host:~$ mitmdump --help
user@host:~$ mitmproxy --help
user@host:~$ mitmweb --help

Command line options:

user@host:~$ mitmdump --options
user@host:~$ mitmproxy --options
user@host:~$ mitmweb --options

Interactive help in mitmproxy:

?

To install mitmproxy on Debian:

root@host:~$ apt-get -y install mitmproxy

The configuration parameters in the Configuration Files use the exact same format as the command line options, documented in the manual page, just without the -- prefix.

Example: Setting the output of all mitmproxy command line tools to verbose:

user@host:~$ vi ~/.mitmproxy/common.conf

File contents:

~/.mitmproxy/common.conf

verbose=true

Example: Enabling the event log of the mitmproxy command line tool, setting its operation mode to reverse proxy and giving the upstream server to connect to as a parameter:

user@host:~$ vi ~/.mitmproxy/mitmproxy.conf

File contents:

~/.mitmproxy/mitmproxy.conf

eventlog=true
reverse=https://www.bityard.org

mitmdump:

root@host:~$ mitmdump

mitmproxy:

root@host:~$ mitmproxy

mitmweb:

root@host:~$ mitmweb

The mitmweb command line tool starts a webserver listening at http://<hostname>:8081/ to which a browser connection should be opened.

None

None