ooni-probe - network measurement framework aimed at detecting network interference | HACK4NET

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.

ooniprobe is the first program that users run to probe their network and to collect data for the OONI project. Are you interested in testing your network for signs of surveillance and censorship? Do you want to collect data to share with others, so that you and others may better understand your network? If so, please read this document and we hope ooniprobe will help you to gather network data that will assist you with your endeavors!

Installation

macOS

You can install ooniprobe on macOS if you have installed homebrew (http://brew.sh/) with:

brew install ooniprobe

Unix systems (with pip)

Make sure you have installed the following dependencies:

build-essential

python (>=2.7)

python-dev

pip

libgeoip-dev

libdumbnet-dev

libpcap-dev

libssl-dev

libffi-dev

tor (>=0.2.5.1 to run all the tor related tests)

Optional dependencies:

obfs4proxy

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 tor libssl-dev obfs4proxy

Then you should be able to install ooniprobe by running:

sudo pip install ooniprobe

or install ooniprobe as a user:

pip install ooniprobe

Using ooniprobe

Net test is a set of measurements to assess what kind of internet censorship is occurring.

Decks are collections of ooniprobe nettests with some associated inputs.

Collector is a service used to report the results of measurements.

Test helper is a service used by a probe for successfully performing its measurements.

Bouncer is a service used to discover the addresses of test helpers and collectors.

Github Project