mirror of
https://github.com/casjaysdevdocker/tor
synced 2025-10-14 02:02:18 -04:00
57554833fd
Dockerfile README.md rootfs/tmp/etc/nginx/nginx.conf rootfs/tmp/etc/nginx/vhosts.d/admin.conf rootfs/usr/local/bin/entrypoint.sh rootfs/usr/local/etc/docker/init.d/99-php-fpm.sh rootfs/usr/local/share/
160 lines
4.8 KiB
Markdown
160 lines
4.8 KiB
Markdown
## 🧅 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
|
|
|
|
```shell
|
|
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
|
|
|
|
```shell
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```shell
|
|
docker build \
|
|
--build-arg BUILD_DATE=$(date +%Y%m%d%H%M) \
|
|
--build-arg PHP_VERSION=84 \
|
|
-t tor-custom .
|
|
```
|
|
|
|
## Authors
|
|
|
|
📽 dockermgr: [Github](https://github.com/dockermgr) 📽
|
|
🤖 casjay: [Github](https://github.com/casjay) [Docker](https://hub.docker.com/r/casjay) 🤖
|
|
⛵ CasjaysDevDocker: [Github](https://github.com/casjaysdevdocker) [Docker](https://hub.docker.com/r/casjaysdevdocker) ⛵
|