An interactive TLS-capable intercepting HTTP proxy for penetration testers and software developers.

debugging http http2 man-in-the-middle mitmproxy proxy python security ssl starred-mitmproxy-repo starred-repo tls websocket

Go to file

Maximilian Hils 439e5264eb CONTRIBUTING.md: temporarily remove `--cov` refs #6515		2023-12-02 08:37:37 +07:00
.github	Bump the github-actions group with 1 update (#6516 )	2023-12-02 07:02:17 +07:00
docs	Migrate to ruff (#6433 )	2023-10-31 16:03:53 +01:00
examples	examples/contrib: link to security plugin	2023-11-06 22:56:24 +01:00
mitmproxy	Show exception and stack trace on startup errors (#6491 )	2023-11-18 10:03:50 +01:00
release	macOS: Use correct entitlements for binary distribution (#6480 )	2023-11-13 13:52:55 +01:00
test	Add option to return various status codes rather than killing during server replay (#6465 )	2023-11-08 11:12:44 +01:00
web	Add option to return various status codes rather than killing during server replay (#6465 )	2023-11-08 11:12:44 +01:00
.gitattributes	test dumpfiles: .bin -> .mitm	2021-02-03 19:27:15 +01:00
.gitignore	update kaitai definitions	2022-07-29 16:13:15 +02:00
CHANGELOG.md	mitmproxy 10.1.5	2023-11-14 12:54:48 +00:00
CONTRIBUTING.md	CONTRIBUTING.md: temporarily remove `--cov`	2023-12-02 08:37:37 +07:00
LICENSE	GPLv3 -> MIT	2013-03-18 08:37:42 +13:00
MANIFEST.in	remove pathod and pathoc	2020-12-13 20:21:11 +01:00
README.md	readme: fix nits	2022-12-15 17:50:43 +01:00
SECURITY.md	Create SECURITY.md	2021-09-13 16:34:33 +02:00
codecov.yml	remove `release/` from coverage	2022-07-25 01:39:04 +02:00
pyproject.toml	Bump pyinstaller from 6.1.0 to 6.2.0 (#6519 )	2023-12-02 07:06:11 +07:00
setup.cfg	Migrate to ruff (#6433 )	2023-10-31 16:03:53 +01:00

README.md

mitmproxy

mitmproxy is an interactive, SSL/TLS-capable intercepting proxy with a console interface for HTTP/1, HTTP/2, and WebSockets.

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

mitmweb is a web-based interface for mitmproxy.

Installation

The installation instructions are here. If you want to install from source, see CONTRIBUTING.md.

Documentation & Help

General information, tutorials, and precompiled binaries can be found on the mitmproxy website.

The documentation for mitmproxy is available on our website:

If you have questions on how to use mitmproxy, please use GitHub Discussions!

Contributing

As an open source project, mitmproxy welcomes contributions of all forms.

Also, please feel free to join our developer Slack! However, please note that the primary purpose of our Slack is direct communication between maintainers and contributors. If you have questions where the answer might be valuable to others, please use GitHub Discussions and not Slack.