Docker Tor

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's 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

Automated builds of the image are available on my Docker Hub and is the recommended method of installation.

docker pull bogny/tor

Alternatively you can build the image yourself.

docker build -t 'tor' -i bogny/tor:latest

Quick Start

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

wget https://raw.githubusercontent.com/bogny/tor/master/docker-compose.yml
docker-compose up -d

Alternately, you can manually launch the tor container.

docker run --name='tor' -d -i bogny/tor:latest

The exposed ports are:

• 9050: Tor proxy (SOCKS5)
• 9051: Tor control port

Binding port 9051 are optional. Port 9051 is the control port of Tor Network. Using that you can forcefully regenerate the Tor ip. Read more about tor_ip_renew.py

Verify

How to cross-check are you getting ip from Tor or not.

Check your IP without Tor

curl https://ipecho.net/plain

or

wget -qO- https://ipecho.net/plain ; echo

Check with Tor

curl -v --socks5-hostname localhost:9050 https://ipecho.net/plain

Maintenance

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 sh

Debug

If the above step is not success, you have to verify the log files.

Upgrading

To upgrade to newer releases:

• Step 1: Download the updated Docker image:

docker pull bogny/tor

• Step 2: Stop the currently running image:

docker stop tor

• Step 3: Remove the stopped container

docker rm -v tor

• Step 4: Start the updated image

docker run --name 'tor' -d -i bogny/tor:latest

Credits

This repository is based on content and work from the following article/repository:

• https://github.com/dockage/tor-privoxy
• https://www.arulraj.net/2015/05/docker-container-for-tor-with-privoxy.html
• https://github.com/arulrajnet/torprivoxy
• https://wildcardcorp.com/blogs/tor-torify-torsocks