/proxy-tor-privoxy

Docker Tor proxy (http and shell) built on Alpine Linux

Primary LanguageDockerfileApache License 2.0Apache-2.0

tor-privoxy GitHub Workflow Status (branch) Docker Pulls Docker Stars

This image combines Tor and Privoxy services to prepare proxy connection for http and shell.

Contributing

If you find this image useful here's how you can help:

  • Send a pull request with your awesome features and bug fixes
  • Help users resolve their issues.

Issues

Before reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker installation guide for instructions.

SELinux users should try disabling SELinux using the command setenforce 0 to see if it resolves the issue.

If the above recommendations do not help then report your issue along with the following information:

  • Output of the docker vers6 and docker info commands
  • The docker run command or docker-compose.yml used to start the image. Mask out the sensitive bits.
  • Please state if you are using Boot2Docker, VirtualBox, etc.

Getting started

Installation

Automated builds of the image are available on Dockerhub and is the recommended method of installation.

docker pull dockage/tor-privoxy

Alternatively you can build the image yourself.

docker build -t dockage/tor-privoxy https://github.com/dockage/tor-privoxy.git#main

Quick Start

The quickest way to get started is using docker-compose.

wget https://raw.githubusercontent.com/dockage/tor-privoxy/master/docker-compose.yml
docker-compose up

Alternately, you can manually launch the tor-privoxy container.

docker run --name='tor-privoxy' -d \
  -p 9050:9050 \
  -p 9051:9051 \
  -p 8118:8118 \
dockage/tor-privoxy:latest

The exposed ports are:

  • 9050: Tor proxy (SOCKS5)
  • 9051: Tor control port
  • 8118: Privoxy (HTTP Proxy)

You can extend torrc configuration by placing configuration file in /etc/torrc.d. You must use .conf extension to be include in torrc configuration.

Maintenance

Upgrading

To upgrade to newer releases:

  • Step 1: Download the updated Docker image:
docker pull dockage/tor-privoxy
  • Step 2: Stop the currently running image:
docker stop tor-privoxy
  • Step 3: Remove the stopped container
docker rm -v tor-privoxy
  • Step 4: Start the updated image
docker run --name tor-privoxy -d \
[OPTIONS] \
dockage/tor-privoxy:latest

Shell Access

For debugging and maintenance purposes you may want access the containers shell. If you are using Docker version 1.3.0 or higher you can access a running containers shell by starting bash using docker exec:

docker exec -it tor-privoxy sh

Quick reference