README.md

Docker Image Packaging for mitmproxy

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

Learn more about mitmproxy: https://docs.mitmproxy.org/

Supported Tags and Respective Packer Template Links

• alvistack/mitmproxy-11.0
  • packer/docker-11.0/packer.json

Overview

This Docker container makes it easy to get an instance of mitmproxy up and running.

Based on Official Ubuntu Docker Image with some minor hack:

• Packaging by Packer Docker builder and Ansible provisioner in single layer
• Handle ENTRYPOINT with catatonit

Quick Start

Start mitmproxy:

# Pull latest image
docker pull alvistack/mitmproxy-11.0

# Run as detach
docker run \
    -itd \
    --name mitmproxy \
    --publish 8080:8080 \
    alvistack/mitmproxy-11.0

Success. mitmproxy is now available on port 8080.

Versioning

YYYYMMDD.Y.Z

Release tags could be find from GitHub Release of this repository. Thus using these tags will ensure you are running the most up to date stable version of this image.

YYYYMMDD.0.0

Version tags ended with .0.0 are rolling release rebuild by GitLab pipeline in weekly basis. Thus using these tags will ensure you are running the latest packages provided by the base image project.

License

• Code released under Apache License 2.0
• Docs released under CC BY 4.0

Author Information

• Wong Hoi Sing Edison
  • https://twitter.com/hswong3i
  • https://github.com/hswong3i