https://github.com/PeterDaveHello/tor-socks-proxy
🐳 Tiny Docker image (🤏 10MB) as 🧅 Tor SOCKS5 proxy 🛡
https://github.com/PeterDaveHello/tor-socks-proxy
hacktoberfest onion privacy proxy proxy-server socks socks-proxy socks5 tor tor-socks-proxy web
Last synced: 17 days ago
JSON representation
🐳 Tiny Docker image (🤏 10MB) as 🧅 Tor SOCKS5 proxy 🛡
- Host: GitHub
- URL: https://github.com/PeterDaveHello/tor-socks-proxy
- Owner: PeterDaveHello
- License: gpl-3.0
- Created: 2017-01-10T01:17:36.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-11T17:28:49.000Z (4 months ago)
- Last Synced: 2025-02-13T08:22:19.724Z (2 months ago)
- Topics: hacktoberfest, onion, privacy, proxy, proxy-server, socks, socks-proxy, socks5, tor, tor-socks-proxy, web
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/peterdavehello/tor-socks-proxy/
- Size: 52.7 KB
- Stars: 561
- Watchers: 13
- Forks: 123
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Tor-socks-proxy
[](https://app.travis-ci.com/PeterDaveHello/tor-socks-proxy)
[](https://hub.docker.com/r/peterdavehello/tor-socks-proxy/)
[](https://hub.docker.com/r/peterdavehello/tor-socks-proxy/)
The super easy way to set up a [Tor](https://www.torproject.org) [SOCKS5](https://en.wikipedia.org/wiki/SOCKS#SOCKS5) [proxy server](https://en.wikipedia.org/wiki/Proxy_server) inside a [Docker](https://en.wikipedia.org/wiki/Docker_(software)) [container](https://en.wikipedia.org/wiki/Container_(virtualization)), without Tor relay/exit node function enabled.
## Docker image Repository
We push the built image to Docker Hub and GitHub Container Registry:
- GitHub Container Registry:
- `ghcr.io/peterdavehello/tor-socks-proxy`
-
- Docker Hub:
- `peterdavehello/tor-socks-proxy`
-
Use the prefix `ghcr.io/` if you prefer to use GitHub Container Registry.
## Usage
### First-Time Setup
```sh
docker run -d --restart=always --name tor-socks-proxy -p 127.0.0.1:9150:9150/tcp peterdavehello/tor-socks-proxy:latest
```
- `--restart=always`: This ensures the container automatically restarts whenever the system reboots.
- `-p 127.0.0.1:9150:9150/tcp`: This binds the container to localhost, and you should not change this IP unless you want to expose the proxy to a local network or the Internet.
- You can change the first `9150` to any available port. Please note that ports `9050`/`9150` may be occupied if you are running another Tor client like TorBrowser.
### Start or stop an existing Instance manually
```sh
docker start tor-socks-proxy
```
```sh
docker stop tor-socks-proxy
```
### Checking the Proxy Status and logs
```sh
docker logs tor-socks-proxy
```
### Configuring a Client to Use the Proxy
```sh
curl --socks5-hostname 127.0.0.1:9150 https://ipinfo.tw/ip
```
### Stopping the Proxy
```sh
docker stop tor-socks-proxy
```
## IP Renewal
By default, Tor automatically changes IPs every 10 minutes. You can manually renew the IP by restarting the container:
```sh
docker restart tor-socks-proxy
```
## DNS over Tor
Publish DNS port during setup to query DNS requests over Tor:
```sh
docker run -d --restart=always --name tor-socks-proxy -p 127.0.0.1:9150:9150/tcp -p 127.0.0.1:53:8853/udp peterdavehello/tor-socks-proxy:latest
```
## Sponsor
This project is now sponsored by DigitalOcean, providing us with a dedicated development and testing environment.
For cloud VPS hosting with $200 in free credit, consider using my DigitalOcean referral link: https://m.do.co/c/1fdd0a1d695a
## Support Tor Project
Support the Tor project by [setting up Tor bridge/exit nodes](https://trac.torproject.org/projects/tor/wiki/TorRelayGuide) and [donating](https://donate.torproject.org/).