https://github.com/datawookie/docker-tor-privoxy
https://github.com/datawookie/docker-tor-privoxy
docker privoxy proxy tor
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/datawookie/docker-tor-privoxy
- Owner: datawookie
- Created: 2020-04-06T07:42:32.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-09-18T10:47:20.000Z (almost 6 years ago)
- Last Synced: 2025-04-04T09:36:04.581Z (over 1 year ago)
- Topics: docker, privoxy, proxy, tor
- Language: Shell
- Size: 37.1 KB
- Stars: 6
- Watchers: 2
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
An image based on Alpine Linux with [Tor](https://www.torproject.org/), [Privoxy](https://www.privoxy.org/) and [Squid](http://www.squid-cache.org/).
# Background
Tor provides a SOCKS proxy. We use Privoxy to add an HTTP proxy.
# Docker Image
These ports are exposed by the image:
- `8888` — Tor HTTP proxy
- `9050` — Tor [SOCKS5](https://en.wikipedia.org/wiki/SOCKS) proxy and
- `9051` — Tor control.
### Build
A pre-built image is available [here](https://hub.docker.com/repository/docker/datawookie/tor-privoxy). Pull it using:
```bash
$ docker pull datawookie/tor-privoxy
```
You can also build your own using this repository:
```bash
$ docker build -t tor-privoxy .
```
Or use the `Makefile` as follow:
```bash
$ make build
```
### Run
To launch the pre-built image:
```bash
docker run --rm --name tor -p 8888:8888 -p 9050:9050 datawookie/tor-privoxy
```
You can also launch the image built from this repository:
```bash
docker run -p 8888:8888 -p 9050:9050 tor-privoxy
```
Or use the `Makefile` as follow:
```bash
$ make run
```
### Environment Variables
The following environment variables will modify the behaviour of the container:
- `IP_CHANGE_SECONDS` - Number of seconds between changes of Tor exit address.
- `EXIT_NODE`
- `LOG_NOTICE_TARGET` - Where should logging go?
For example:
```bash
docker run -e IP_CHANGE_SECONDS=180 tor-privoxy
```
### Check
To check that you are on Tor:
- configure your browser to use 127.0.0.1:8888 as proxy then
- browse to https://check.torproject.org/.
## Using Tor
### Shell
```bash
# Direct access to internet.
$ curl http://httpbin.org/ip
{
"origin": "105.224.106.150"
}
# Access internet through Tor (HTTP proxy).
$ curl --proxy 127.0.0.1:8888 http://httpbin.org/ip
{
"origin": "185.220.102.4"
}
# Access internet through Tor (SOCKS proxy).
$ curl --proxy socks5://127.0.0.1:9050 http://httpbin.org/ip
{
"origin": "185.100.87.206"
}
```
You get a different IP address when you send the request via the proxy. If you wait a while and then send the request again, you'll find that the IP address has changed.
### Python
The [stem](https://stem.torproject.org/) package exposes functionality for interacting with the Tor controller interface.
```bash
pip3 install stem
```
Use the requests package to send requests via the Tor proxies.
```python
>>> import requests
>>> requests.get("http://httpbin.org/ip").json()
{'origin': '105.224.106.150'}
>>> requests.get("http://httpbin.org/ip", proxies={"http": "http://127.0.0.1:8888"}).json()
{'origin': '185.220.102.4'}
>>> requests.get("http://httpbin.org/ip", proxies={"http": "socks5://127.0.0.1:9050"}).json()
{'origin': '185.100.87.206'}
```
This assumes that you've installed the `requests` module with support for SOCKS5.
```bash
pip3 install -U requests[socks]
```
### R
```r
> library(httr)
> GET("http://httpbin.org/ip")
{
"origin": "105.224.106.150"
}
> GET("http://httpbin.org/ip", use_proxy("http://127.0.0.1:8888"))
{
"origin": "185.220.102.4"
}
> GET("http://httpbin.org/ip", use_proxy("socks5://127.0.0.1:9050"))
{
"origin": "185.100.87.206"
}
```
## Setting Exit Nodes
It's possible to restrict the exit nodes via the configuration in `torrc`.
```
# Specify exit node by IP address.
ExitNodes 176.10.99.202
# Specify exit node by fingerprint.
ExitNodes 19B6F025B4580795FBD9F3ED3C6574CDAF979A2F
# Specify exit node by country code.
ExitNodes {us} StrictNodes 1
ExitNodes {ua},{ug},{ie} StrictNodes 1
```
You can also exclude specific nodes.
```
ExcludeExitNodes {ua}
```
Note that `ExcludeExitNodes` takes precedence over `ExitNodes`.
There are three ways to specify exit nodes:
- using [country codes](https://b3rn3d.herokuapp.com/blog/2014/03/05/tor-country-codes)
- IP addresses or
- hashes.
If you want to specify multiple options, use a comma-separated list.
Country codes need to be enclosed in braces, for example, `{us}`.
## Similar Projects
- https://github.com/mattes/rotating-proxy (Provides access to multiple simultaneous Tor proxies)
- https://github.com/wallneradam/docker-tor-proxy
- https://hub.docker.com/r/dperson/torproxy and https://github.com/dperson/torproxy