mitmproxy/release/docker

mitmproxy

Containerized version of mitmproxy, an interactive SSL-capable intercepting HTTP proxy.

Usage

$ docker run --rm -it [-v ~/.mitmproxy:/home/mitmproxy/.mitmproxy] -p 8080:8080 mitmproxy/mitmproxy

The volume mount is optional: It's to store the generated CA certificates.

Once started, mitmproxy listens as a HTTP proxy on localhost:8080:

$ http_proxy=http://localhost:8080/ curl http://example.com/
$ https_proxy=http://localhost:8080/ curl -k https://example.com/

You can also start mitmdump by just adding that to the end of the command-line:

$ docker run --rm -it -p 8080:8080 mitmproxy/mitmproxy mitmdump

For mitmweb, you also need to expose port 8081:

# this makes :8081 accessible to the local machine only
$ docker run --rm -it -p 8080:8080 -p 127.0.0.1:8081:8081 mitmproxy/mitmproxy mitmweb --web-iface 0.0.0.0

You can also pass options directly via the CLI:

$ docker run --rm -it -p 8080:8080 mitmproxy/mitmproxy mitmdump --set ssl_insecure=true

For further details, please consult the mitmproxy documentation.

Tags

The available release tags can be seen here.

• master always tracks the git-master branch and represents the unstable development tree.
• latest always points to the same image as the most recent stable release, including bugfix releases (e.g., 4.0.0 and 4.0.1).
• X.Y.Z tags contain the mitmproxy release with this version number.
  • All packages, dependencies, and the base image that were available at the time of the mitmproxy release.
  • We DO NOT update these images! Use at your own risk!
  • These images MIGHT BE affected by potential security issues!
  • Security issues that were made public AFTER the release MIGHT affect these images!
• *-ARMv7 are images built for Raspbian / Raspberry Pi