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/multitoris 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
-k, --kill kill all multitor 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 balancerRequirements
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.
TOR is a fine security project and an excellent component in a strategy of defence in depth but it isn’t (sadly) a cloak of invisibility. When using the TOR, always remember about ssl (eg. https) wherever it is possible.