Skip to main content

Network measurement tool foridentifying traffic manipulation and blocking.

Project description

https://travis-ci.org/TheTorProject/ooni-probe.png?branch=master https://coveralls.io/repos/TheTorProject/ooni-probe/badge.png
https://ooni.torproject.org/images/ooni-header-mascot.png

OONI, the Open Observatory of Network Interference, is a global observation network which aims is to collect high quality data using open methodologies, using Free and Open Source Software (FL/OSS) to share observations and data about the various types, methods, and amounts of network tampering in the world.

Read this before running ooniprobe!

Running ooniprobe is a potentially risky activity. This greatly depends on the jurisdiction in which you are in and which test you are running. It is technically possible for a person observing your internet connection to be aware of the fact that you are running ooniprobe. This means that if running network measurement tests is something considered to be illegal in your country then you could be spotted.

Furthermore, ooniprobe takes no precautions to protect the install target machine from forensics analysis. If the fact that you have installed or used ooni probe is a liability for you, please be aware of this risk.

Setup ooniprobe

To install ooniprobe you will need the following dependencies:

  • python
  • python-dev
  • python-setuptools
  • build-essential
  • libdumbnet1
  • python-dumbnet
  • python-libpcap
  • tor
  • libgeoip-dev
  • libpcap0.8-dev
  • libssl-dev
  • libffi-dev
  • libdumbnet-dev

On debian based systems this can generally be done by running:

sudo apt-get install -y build-essential libdumbnet-dev libpcap-dev libgeoip-dev libffi-dev python-dev python-pip

When you got them run:

sudo pip install ooniprobe

Using ooniprobe

It is recommended that you start the ooniprobe-agent system daemon that will expose a localhost only Web UI and automatically run tests for you.

This can be done with:

ooniprobe-agent start

Then connect to the local web interface on http://127.0.0.1:8842/

Have fun!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ooniprobe-2.3.0.tar.gz (1.9 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page