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.