iamtofr / docker-tinyproxy

A quick and easy to use Dockerised Tinyproxy with configurable ACL.

Docker Tinyproxy

A quick and easy Dockerised Tinyproxy with configurable ACL.

Find it on GitHub.

Find it on DockerHub.

Usage

---

Running a new Tinyproxy container

Usage:
    docker run -d --name='tinyproxy' -p <Host_Port>:8888 --env BASIC_AUTH_USER=<username> --env BASIC_AUTH_PASSWORD=<password> --env TIMEOUT=<timeout> monokal/tinyproxy:latest <ACL>

        - Set <Host_Port> to the port you wish the proxy to be accessible from.
        - Set <ACL> to 'ANY' to allow unrestricted proxy access, or one or more space seperated IP/CIDR addresses for tighter security.
        - Basic auth is optional.
        - Timeout is optional.

    Examples:
        docker run -d --name='tinyproxy' -p 6666:8888 monokal/tinyproxy:latest ANY
        docker run -d --name='tinyproxy' -p 7777:8888 monokal/tinyproxy:latest 87.115.60.124
        docker run -d --name='tinyproxy' -p 8888:8888 monokal/tinyproxy:latest 10.103.0.100/24 192.168.1.22/16

Monitoring

---

Logs

docker logs -f tinyproxy will display a following tail of /var/log/tinyproxy/tinyproxy.log

Stats

Navigating to http://tinyproxy.stats/ while connected to the proxy will display the Tinyproxy Stats page.

Filtering

Any Tinyproxy filter setting such as FilterDefaultDeny can be set as an environment variable. You can map a filter file on the parent file system into the container for the proxy instance to use.

        docker run -d --name='tinyproxy' -p 6666:8888 -v ~/filter-on-parent.conf:/etc/tinyproxy/filter.conf  --env Filter="/etc/tinyproxy/filter.conf" --env FilterDefaultDeny=Yes  monokal/tinyproxy:latest ANY

Contribute

---

As always, contributions are appriciated. Simply open a Pull request.