🧅 Tor Docker Container with Admin Panel 🚀

A comprehensive Docker container providing Tor services (bridge, relay, server) with hidden service support, DNS resolution, HTTP proxy, and a complete web-based admin panel.

✨ Features

• Tor Services: Bridge, Relay, and Server modes
• Hidden Services: Easy .onion site creation and management
• DNS Resolution: Unbound DNS resolver with .onion domain support
• HTTP Proxy: Privoxy for web traffic routing through Tor
• Web Interface: Nginx with PHP support
• Admin Panel: Complete web-based management interface
• REST API: JWT-authenticated API for automation

🚀 Quick Start

Build Container

git clone "https://github.com/casjaysdevdocker/tor" "$HOME/Projects/github/casjaysdevdocker/tor"
cd "$HOME/Projects/github/casjaysdevdocker/tor"
docker build -t casjaysdevdocker/tor .

Run Container

docker run -d \
  --name tor-container \
  -p 8080:80 \
  -p 9050:9050 \
  -p 9053:9053 \
  -p 8118:8118 \
  -e TOR_ADMIN_USER=admin \
  -e TOR_ADMIN_PASS=secure_password \
  -v "/var/lib/srv/$USER/docker/casjaysdevdocker/tor/latest/data:/data" \
  -v "/var/lib/srv/$USER/docker/casjaysdevdocker/tor/latest/config:/config" \
  casjaysdevdocker/tor

🔐 Admin Panel

Access the web-based admin panel at: http://localhost:8080/admin/

Authentication

Set admin credentials via environment variables:

• TOR_ADMIN_USER (default: admin)
• TOR_ADMIN_PASS (default: torpass123)
• TOR_JWT_SECRET (optional: custom JWT secret)

Features

• Dashboard: Service status monitoring and control
• Configuration: Edit Tor, Nginx, Unbound, Privoxy configs
• Hidden Services: Create and manage .onion sites
• Logs: Real-time log monitoring with auto-refresh
• API Tokens: Generate JWT tokens for programmatic access

🔗 REST API

Authentication

# Get JWT token
curl -X POST http://localhost:8080/admin/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your_password"}'

Service Management

# List all services
curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:8080/admin/api/services

# Get specific service status
curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:8080/admin/api/services/tor-server

# Restart a service
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:8080/admin/api/services/tor-server/restart

Hidden Services

# List hidden services
curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:8080/admin/api/hidden-services

# Create hidden service
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"myapp","port_mapping":"80 127.0.0.1:8080"}' \
  http://localhost:8080/admin/api/hidden-services

🌐 Network Ports

Port	Service	Description
80	Nginx	Web server and admin panel
8118	Privoxy	HTTP proxy
9040	Tor	Transparent proxy
9050	Tor	SOCKS proxy
9053	Unbound	DNS resolver
9080	Tor	HTTP tunnel
57000-57010	Tor	Bridge/Relay ports

📁 Directory Structure

• /config - Configuration files (persistent)
• /data - Data files and logs (persistent)
• /data/logs - Service logs
• /data/tor/server/services - Hidden service data
• /data/htdocs - Web content for hidden services

⚙️ Environment Variables

Admin Panel

• TOR_ADMIN_USER - Admin username (default: admin)
• TOR_ADMIN_PASS - Admin password (default: torpass123)
• TOR_JWT_SECRET - JWT signing secret (auto-generated if not set)

Tor Configuration

• TOR_BRIDGE_ENABLED - Enable bridge mode (default: yes)
• TOR_RELAY_ENABLED - Enable relay mode (default: yes)
• TOR_HIDDEN_ENABLED - Enable hidden services (default: yes)
• TOR_DNS_ENABLED - Enable DNS forwarding (default: yes)
• TOR_DEBUG - Enable debug logging (default: no)

Service Ports

• TOR_BRIDGE_PT_PORT - Bridge transport port (default: 57003)
• TOR_RELAY_PORT - Relay transport port (default: 57000)
• TOR_SERVER_ACCOUNT_MAX - Monthly bandwidth limit (default: 250 GBytes)

🔧 Development

Build with Custom Options

docker build \
  --build-arg BUILD_DATE=$(date +%Y%m%d%H%M) \
  --build-arg PHP_VERSION=84 \
  -t tor-custom .

Authors

📽 dockermgr: Github 📽
🤖 casjay: Github Docker 🤖
⛵ CasjaysDevDocker: Github Docker ⛵