Tor Proxy Docker Image

Overview

This Docker image provides a simple and easy-to-use Tor proxy service. Tor is a free and open-source software that anonymizes internet traffic by routing it through a worldwide network of relays.

Features

• Tor Proxy: Configured as a SOCKS5 proxy on port 9050.
• Automatic Reconnection: Ensures that Tor reconnects automatically in case of disconnection.
• Healthcheck: Regularly checks the health of the Tor service and restarts it if necessary.

Usage

Build the Docker Image

To build the Docker image from the Dockerfile, run the following command:

docker build -t tor-proxy .

Run the Docker Container

To run the Docker container, use the following command:

docker run -d -p 9050:9050 --name tor-proxy wafy80/tor

Using the Tor Proxy

Once the container is running, you can configure your applications to use the Tor proxy. For example, using curl:

curl --socks5-hostname 127.0.0.1:9050 http://check.torproject.org/

This command should indicate that your request is routed through the Tor network.

Healthcheck

The Docker image includes a healthcheck that verifies the Tor service is running correctly. The healthcheck is configured as follows:

• Interval: Every 30 seconds.
• Timeout: 10 seconds.
• Retries: 3 attempts before marking the container as unhealthy.

Checking Health Status

You can check the health status of the container using the following command:

docker inspect tor-proxy-container

Look for the State and Health sections in the output JSON to see the health status of the container.

Contributing

Contributions are welcome! If you have any improvements or bug fixes, feel free to open a pull request.

License

This Docker image is licensed under the WTFPL License.