redoracle/tor-gateway repository overview

Tor Gateway

Tor Gateway is a lightweight, containerized solution for secure access to the Tor network. Built on Alpine Linux, it integrates Privoxy, runit, and a dynamic web UI to provide a robust and customizable Tor proxy gateway.

🔧 Features • Minimal & Secure: Based on Alpine Linux. • Privoxy Integration: HTTP proxy routing via Tor. • Environment-Based Config: All Tor settings configured via .env file (prefix TOR_). • Dynamic Reloading: Web UI updates .env and triggers graceful container restarts. • Process Supervision: Managed with runit for high reliability. • Non-root User: Runs securely without root privileges. • Web UI: View exit node info and update configuration on-the-fly.

🚀 Quick Start

docker run -d
--restart unless-stopped
--name Tor-Gateway
-p 8118:8118
-p 8080:5000
--env-file "$(pwd)/.env"
-v "$(pwd)/.env:/home/dockeruser/.env"
redoracle/tor-gateway:latest

📍 Access the proxy on port 8118 🌐 View the UI at http://localhost:8080⁠

🛠️ Configuration Example (.env)

TOR_ExitNodes="{de},{fr}" TOR_StrictNodes="1" TOR_ControlPort=9052 TOR_HashedControlPassword="your-hashed-password"

🔐 Use tor --hash-password your_password to generate your control password.

🧱 Docker Compose Integration

Easily integrate into a Docker stack alongside tools like Pi-hole, WireGuard, or crawlers. See the examples folder in the repo.

📚 Documentation & Support

Full documentation, deployment guides, and FAQs are available on GitHub. Issues and contributions are welcome!

🔗 Resources • 📦 Docker Hub: redoracle/tor-gateway • 📦 GitHub: github.com/redoracle/tor-gateway • 🌐 Tor Project: https://www.torproject.org⁠

Secure your traffic. Route it through Tor. Run it with confidence.