Skip to content

Latest commit

 

History

History
135 lines (97 loc) · 3.54 KB

README.md

File metadata and controls

135 lines (97 loc) · 3.54 KB

If you need molehole to fanced sites, talpa can help you. This kind of talpa have tor, socks and squid.

Background

Tor provides a SOCKS proxy. Privoxy provide an HTTP proxy. Squid help with routing. These ports are exposed by the image:

  • 8888 ⁠— Tor HTTP proxy passthrough squid
  • 9050 ⁠— Tor SOCKS5 proxy direct
  • 9051 ⁠— Tor control

Build

A pre-built image is available here. Pull it using:

$ docker pull mcgr0g/talpa-altaica

You can also build your own using this repository. Check docs/build

Run

docker run --rm --name torproxy -p 8888:8888 -p 9050:9050 mcgr0g/talpa-altaica

Or use the Makefile as follow:

make run

Or use the docker-compose up with such config

version: '3.8'
services:

  molehole:
    container_name: torproxy
    image: mcgr0g/talpa-altaica:latest
    environment:
     EXCLUDE_NODE: '{RU},{UA},{AM},{KG},{BY}'
    ports:
    - 8888:8888
    - 9050:9050/tcp
    restart: unless-stopped

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 - Specify exit node location via alpha-2 country codes
  • LOG_NOTICE_TARGET - Where should logging go?
  • EXCLUDE_NODE - What county ignore to use in Exit nodes, spec via alpha-2 country codes

For example:

docker run -e IP_CHANGE_SECONDS=180 talpa-altaica

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:

If you want to specify multiple options, use a comma-separated list.

Country codes need to be enclosed in braces, for example, {us}.

Check

To check that you are on Tor:

Other checks via cli you can find in docs/checks

Below most popular check in shell

Shell

# 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.

Similar Projects