A Dockerized Tor proxy server that routes internet traffic through the Tor network via a SOCKS5 proxy with DNS support. Offers multiple image variants including Debian and Alpine for minimal footprint. Supports bridge protocols (obfs4, meek, snowflake) for circumventing network censorship, exit node selection by country, and multi-architecture builds for amd64 and arm64. Includes HAProxy load balancing for multi-instance deployments with round-robin circuit rotation, persistent storage for maintaining Tor state, non-root container execution, cosign image signing, and Trivy vulnerability scanning in CI/CD. Available on Docker Hub and GitHub Container Registry.
git clone https://github.com/mstfknn/tor-proxy.git
# Quick start
docker run -d --name tor-proxy -p 9150:9150 -p 8853:5353/udp \
mstfknn/tor-proxy:debian
# Test connectivity
curl --socks5-hostname localhost:9150 \
https://check.torproject.org/api/ip
# With exit node filtering
docker run -d --name tor-proxy -p 9150:9150 \
-e EXIT_NODES="{US},{GB},{DE}" \
-e STRICT_NODES=1 \
mstfknn/tor-proxy:debian