/exitmap

Performs a task over (a subset of) all Tor exit relays.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

exitmap logo

Overview

exitmap is a fast and modular Python-based scanner for Tor exit relays. Modules implement tasks which can be executed over (a subset of) all exit relays.

The tool uses Stem to initiate circuits over all given exit relays and as soon as tor notifies exitmap of an established circuit, a module is invoked for the newly established circuit.

exitmap has been used to check for false positives on the Tor Project's check service and to find malicious exit relays.

Installation

exitmap uses the library Stem to communicate with Tor. On Debian jessie and newer, you can install Stem by executing:

# apt-get install python-stem

Running exitmap

You can run exitmap with the checktest module by executing:

$ python exitmap.py CCEF02AA454C0AB0FE1AC68304F6D8C4220C1912 checktest

To run the same test over German exit relays only, execute:

$ python exitmap.py -C DE CCEF02AA454C0AB0FE1AC68304F6D8C4220C1912 checktest

Note that CCEF02AA454C0AB0FE1AC68304F6D8C4220C1912 is a relay run by Karlstad University. While you can feel free to use it, please use your own relays in order to distribute the scanning load.

Alternatives

Don't like exitmap? Then have a look at tortunnel, SoaT, torscanner, or DetecTor.

Feedback

Contact: Philipp Winter phw@nymity.ch
OpenPGP fingerprint: B369 E7A2 18FE CEAD EB96 8C73 CF70 89E3 D7FD C0D0