wafy80/tor repository overview

⁠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. https://github.com/wafy80/tor⁠

⁠License

This Docker image is licensed under the WTFPL License⁠.