Docker-Tor-Redsocks

A Docker base image that sets up a transparent proxy stack using Tor and Redsocks with iptables redirection. Import it into your Dockerfile to run any application behind a Tor-anonymized network.

Features

• Alpine and Ubuntu variants (Dockerfile.alpine, Dockerfile.ubuntu)
• Uses default Tor exit nodes (no country restriction)
• Redsocks for transparent TCP proxying
• iptables rules redirect all outbound traffic through Tor
• Automatic monitoring and restart on failure
• Readiness indicator: /tmp/redsocks.ready

Files

File	Description
__setup_proxy.sh	Proxy setup and monitoring script
Dockerfile.alpine	Lightweight Alpine-based image
Dockerfile.ubuntu	Ubuntu-based image

Usage

1. Import into your Dockerfile

# FROM ghcr.io/techroy23/docker-tor-redsocks:alpine
# or
# FROM ghcr.io/techroy23/docker-tor-redsocks:ubuntu

COPY . /app
RUN chmod +x /app/*.sh

ENTRYPOINT ["/app/your_program.sh"]

2. Run with required capabilities

docker run -it --rm \
  --sysctl net.ipv4.ip_forward=1 \
  --cap-add=NET_ADMIN --cap-add=NET_RAW \
  yourimage:latest

3. In your entrypoint script

#!/bin/bash
set -e

/app/__setup_proxy.sh &

while [ ! -f /tmp/redsocks.ready ]; do
    sleep 5
done

echo "Proxy ready!"
./your_program

Environment Variables

Variable	Default	Description
SHOW_LOGS	false	Show Tor logs (true/false)

Example

# Show Tor logs
docker run -e SHOW_LOGS=true yourimage

Notes

• Requires NET_ADMIN and NET_RAW capabilities
• Tor runs as dedicated toruser
• Tor uses its default exit nodes (no country restriction)