On this page
Overview
mitmproxy provides terminal, web, and non-interactive interfaces for capturing, inspecting, replaying, and modifying HTTP(S), HTTP/2, and WebSocket flows, including Python addons for automation.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Key features
Capture, filter, and replay requests and responses
mitmproxy, mitmweb, and mitmdump expose flows for inspection, filtering, saving, replay, and automated Python addon processing.
Sources: [1]
Best fit
Fits API, browser, and mobile debugging plus authorized security tests
Point a client at a local proxy to inspect headers, cookies, TLS behavior, and WebSocket messages while reproducing integration or protocol issues.
Sources: [1]
Before adoption
Treat TLS interception authority and CA keys as sensitive
Decryption requires clients to trust a mitmproxy CA. Never intercept third-party traffic, protect credentials and personal data in captures, and remove test trust settings afterward.
Sources: [1]
Official sources
- [1]mitmproxy v12.2.3 README(2026-10-04)
- [2]mitmproxy v12.2.3 release(2026-10-04)
- [3]mitmproxy v12.2.3 license(2026-10-04)
Supplemental curator note
Use it only on traffic you own or are explicitly authorized to test, and protect the generated CA key and captured data as sensitive material.
Try it in 3 steps
- 1
Create an isolated virtual environment
Isolate the proxy and its dependencies.
python3 -m venv mitm-demo && . mitm-demo/bin/activate - 2
Install the reviewed release
Pin the package to the reviewed version.
python -m pip install "mitmproxy==12.2.3" - 3
Inspect version and options before listening
Verify the CLI and options without capturing traffic.
mitmproxy --version && mitmdump --options | head -40
Growth
Growth trends · Last 30 days
45,255 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 20
- Open PRs
- 122
Development activity is still being collected.
Built with
Categories and tags
Categories
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- python
- security
- man-in-the-middle
- tls
- ssl
- http
- http2
- websocket
- proxy
- debugging
- mitmproxy
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- MasterHttpRelayVPN3,935 Stars
2 shared tag(s) · Same language
Understand it as an experimental HTTP/SOCKS relay stack where a local proxy forwards traffic through services such as Google Apps Script
Python - FreeIPA1,288 Stars
2 shared tag(s) · Same language
centralize Linux identity and access with LDAP, Kerberos, PKI, DNS, sudo, and access-control policy
Python - Heliox-OS66 Stars
2 shared tag(s) · Same language
Control an existing OS through natural language, voice, and gestures while routing real actions through permissions, approvals, and verification
Python - Wireshark9,954 Stars
1 shared tag(s) · 2 shared category(s)
Capture, filter, and dissect packets with the Wireshark GUI and TShark for deep protocol and traffic analysis
C - Defguard2,857 Stars
1 shared tag(s) · 2 shared category(s)
combine WireGuard, identity, MFA, and firewall policy in a self-hosted access platform
Rust - mkcert59,717 Stars
1 shared tag(s) · 1 shared category(s)
create a local CA and easily issue browser-trusted TLS certificates for localhost and development domains
Go
Report incorrect information
Tell us if any listing information is incorrect or outdated.