Docker Tor

This repository is for a Tor daemon multiarch docker image.

Full documentation for this Docker image can be found at https://barneybuffet.github.io/docker-tor/

Tor can't help you if you use it wrong! Learn how to be safe at https://www.torproject.org/download/download#warning

What is Tor

The Tor Project is a nonprofit organization primarily responsible for maintaining software for the Tor anonymity network. The Tor browser is the most well known piece of software maintained. The Tor Browser uses the onion network to anonymize browsing and the onion network relies on tor relays to achieve this.

What is this image

This docker image runs a Tor service on an Alpine linux base image. The Tor service that can be configure, as single or combination of a:

1. Tor Socks5 proxy into the onion network (default)
2. Tor hidden service for onion websites. Including client public/private key generation.
3. Tor relay to support the onion network (not supported yet)

The docker image:

• Starts with an Alpine linux base image
• Downloads the Tor source code tarballs signature file
• Verifies the Tor source tarballs against Roger Dingledine: 0xEB5A896A28988BF5 key
• Compiles Tor from source
• Templates out the Tor config file torrc
• Starts the tor service

During container creation the container will log creation of the config file, the templated config file and once created will log any Tor notifications.

This image exposes port 9050/tcp and 9051/tcp.

Data can be persisted and config manual edited by mounting the /tor

How to build this image

docker build -t correctiv/tor .

How to use this image

docker run -d --name tor-proxy -v <absolute-path>:tor -p 9050:9050

Create a docker image with the following docker-compose.yml file

---
version: "3.9"

services:
  tor:
    container_name: tor
    image: correctiv/tor:latest
    environment:
      TOR_LOG_CONFIG:'false'
      TOR_PROXY: 'true'
      TOR_PROXY_PORT: '9050'
      TOR_PROXY_ACCEPT: 'accept 127.0.0.1,accept 10.0.0.0/8,accept 172.16.0.0/12,accept 192.168.0.0/16'
      TOR_PROXY_CONTROL_PORT: '9051'
      TOR_PROXY_CONTROL_PASSWORD: 'password'
      TOR_PROXY_CONTROL_COOKIE: 'true'
      TOR_SERVICE: 'false'
      TOR_RELAY: 'false'
      TOR_SERVICE_HOSTS='radarr=80:192.168.1.12'
      TOR_SERVICE_HOSTS_CLIENTS='radarr=barney'
    volumes:
      - ${PWD}:/tor/
    ports:
      - "9050:9050/tcp"
      - "9051:9051/tcp"
    restart: unless-stopped

References

• Docker Tor - Git Repository
• Docker Tor - Documentation
• Tor Stackexchange

Start Visual Studio code with Tor Proxy