Skip to main content

Network measurement tool for identifying 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/theme/img/ooni-logo.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.

Futhermore, 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

When you got them run:

sudo pip install ooniprobe

Using ooniprobe

To generate a test deck for your country, cd to the directory where you want it and run:

oonideckgen

To setup a daily cronjob run this:

(crontab -l 2>/dev/null; echo "@daily ooniprobe `oonideckgen | grep -e '^ooniprobe'`") | crontab -

Have fun!

Project details


Download files

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

Source Distribution

ooniprobe-1.3.1.tar.gz (138.9 kB view details)

Uploaded Source

File details

Details for the file ooniprobe-1.3.1.tar.gz.

File metadata

  • Download URL: ooniprobe-1.3.1.tar.gz
  • Upload date:
  • Size: 138.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for ooniprobe-1.3.1.tar.gz
Algorithm Hash digest
SHA256 0d90b85f74c9dd98f8f111c058a2a734aa5e0aea927b2653f7a0387c93e090b2
MD5 25b1601286faa44574773a993b815637
BLAKE2b-256 7116bd3f344a4b52c30781c66a57038e659eafe2c6fe462bf3f7271e64cd282c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page