Home

Awesome

<h1 align="center">multitor</h1> <h4 align="center">Create multiple TOR instances with load-balancing.</h4> <p align="center"> <a href="https://travis-ci.org/trimstray/multitor"> <img src="https://travis-ci.org/trimstray/multitor.svg?branch=master" alt="Travis-CI"> </a> <a href="https://img.shields.io/badge/Version-v1.3.0-lightgrey.svg"> <img src="https://img.shields.io/badge/Version-v1.3.0-lightgrey.svg" alt="Version"> </a> <a href="http://www.gnu.org/licenses/"> <img src="https://img.shields.io/badge/license-GNU-blue.svg" alt="License"> </a> </p> <p align="center"> <a href="#description">Description</a> • <a href="#introduction">Introduction</a> • <a href="#how-to-use">How To Use</a> • <a href="#parameters">Parameters</a> • <a href="#requirements">Requirements</a> • <a href="#docker">Docker</a> • <a href="#other">Other</a> • <a href="#license">License</a> • <a href="https://github.com/trimstray/multitor/wiki">Wiki</a> </p> <div align="center"> <sub>Created by <a href="https://twitter.com/trimstray">trimstray</a> and <a href="https://github.com/trimstray/multitor/graphs/contributors">contributors</a> </div> <br> <p align="center"> <img src="https://github.com/trimstray/multitor/blob/master/static/img/multitor_output_1.png" alt="Master"> </p>

Description

It provides one single endpoint for clients. Supports HAProxy, socks protocol and http-proxy servers: polipo, privoxy and hpts.

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:

Introduction

multitor was created with the aim of initialize many TOR processes as quickly as possible. I could use many instances for my daily use programs (web browsers, messangers and other). In addition, I was looking for a tool that would increase anonymity when conducting penetration tests and testing the security of infrastructure.

Before using the multitor you need to remember:

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 (e.g. https) wherever it is possible.

Look also at Limitations.

How To Use

:heavy_exclamation_mark: For a more detailed understanding of multitor, its parameters, functions and how it all 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 --proxy privoxy --haproxy

Parameters

Provides the following options:

  Usage:
    multitor <option|long-option>

  Examples:
    multitor --init 2 --user debian-tor --socks-port 9000 --control-port 9900
    multitor --init 10 --user debian-tor --socks-port 9000 --control-port 9900 --proxy socks
    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 <proxy_type>          set socks or http (polipo, privoxy, hpts) proxy server
        --haproxy                     set HAProxy as a frontend for http proxies (only with --proxy)

Requirements

multitor uses external utilities to be installed before running:

This tool working with:

Also you will need root access.

Docker

See this project: docker-multitor

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

Contributing

See this.

Project architecture

See this.

License

GPLv3 : http://www.gnu.org/licenses/

Free software, Yeah!