Multitor

A tool that lets you create multiple TOR instances with a load-balancing.

Description • How To Use • Parameters • Requirements • Other • License • Wiki

_{Created by
trimstray and

contributors}

Description

A tool that lets you create multiple TOR instances with a load-balancing traffic between them by HAProxy. It's provides one single endpoint for clients. In addition, you can view previously running TOR processes and create a new identity for all or selected processes.

The multitor has been completely rewritten on the basis of:

Multi-TOR project written by Jai Seidl: Multi-TOR

original source is (Sebastian Wain project): Distributed Scraping With Multiple TOR Circuits

How To Use

Before using the multitor, detailed understanding all parameters and how it works, see the Manual.

It's simple:

# Clone this repository
git clone https://github.com/trimstray/multitor

# Go into the repository
cd multitor

# Install
./setup.sh install

# Run the app
multitor --init 2 --user debian-tor --socks-port 9000 --control-port 9900

symlink to bin/multitor is placed in /usr/local/bin

man page is placed in /usr/local/man/man8

Parameters

Provides the following options:

  Usage:
    multitor <option|long-option>

  Examples:
    multitor --init 2 --user debian-tor --socks-port 9000 --control-port 9900
    multitor --show-id --socks-port 9000

  Options:
        --help                      show this message
        --debug                     displays information on the screen (debug mode)
        --verbose                   displays more information about TOR processes
    -i, --init <num>                init new tor processes
    -s, --show-id                   show specific tor process id
    -n, --new-id                    regenerate tor circuit
    -u, --user <string>             set the user (only with -i|--init)
        --socks-port <port_num|all> set socks port number
        --control-port <port_num>   set control port number
        --proxy <socks|http>        set load balancer

Requirements

Multitor uses external utilities to be installed before running:

Also you will need root access.

Other

Important

If you use this tool in other scripts where the output is saved everywhere, not on the screen, remember that you will not be able to use the generated password. I will correct this in the next version. If you do not use regenerate function of single or all TOR circuits with a password, you can safely restart the multitor which will do it for you.

Limitations

each TOR process needs a certain number of memory. If the number of processes is too big, the oldest one will be automatic killed by the system
Polipo is no longer supported but it is still a very good and light proxy. In the next version I will give you the option to choose a different solution.

Contributing

See this.

Project architecture