
La versión heredada en Python de OONI Probe
⚠️⚠️⚠️⚠️: este repositorio contiene el código fuente de la implementación heredada de ooniprobe. Consulte en su lugar:
https://github.com/ooni/probe, el meta-repositorio donde debería abrir incidencias y solicitudes de funcionalidades;
https://github.com/ooni/probe-cli, que contiene la nueva implementación de ooniprobe como cliente de línea de comandos escrito en Go;
https://github.com/ooni/probe-desktop, que contiene la aplicación de escritorio de ooniprobe, escrita en JavaScript y Electron.
¡Gracias por su interés en OONI!
El resto de este archivo contiene el README.rst original de la implementación heredada:
.. image:: https://travis-ci.org/TheTorProject/ooni-probe.png?branch=master :target: https://travis-ci.org/TheTorProject/ooni-probe
.. image:: https://coveralls.io/repos/TheTorProject/ooni-probe/badge.png :target: https://coveralls.io/r/TheTorProject/ooni-probe
.. image:: https://slack.openobservatory.org/badge.svg :target: https://slack.openobservatory.org/badge.svg
.. image:: https://ooni.torproject.org/images/ooni-header-mascot.png :target: https:://ooni.torproject.org/
OONI, el Observatorio Abierto de Interferencias de Red, es una red de observación global cuyo objetivo es recopilar datos de alta calidad utilizando metodologías abiertas, usando Software Libre y de Código Abierto (FL/OSS) para compartir observaciones y datos sobre los diversos tipos, métodos y cantidades de manipulación de red en el mundo.
"La Internet interpreta la censura como daño y la sortea."
- John Gilmore; revista TIME (6 de diciembre de 1993)
ooniprobe es el primer programa que los usuarios ejecutan para sondear su red y recopilar datos para el proyecto OONI. ¿Está interesado en probar su red en busca de signos de vigilancia y censura? ¿Desea recopilar datos para compartir con otros, para que usted y otros puedan comprender mejor su red? Si es así, lea este documento y esperamos que ooniprobe le ayude a recopilar datos de red que le serán de utilidad en sus esfuerzos.
Ejecutar ooniprobe es una actividad potencialmente riesgosa. Esto depende en gran medida de la jurisdicción en la que se encuentre y de la prueba que esté ejecutando. Técnicamente, es posible que una persona que observe su conexión a Internet sepa que está ejecutando ooniprobe. Esto significa que si ejecutar pruebas de medición de red se considera algo ilegal en su país, podría ser detectado.
Además, ooniprobe no toma precauciones para proteger la máquina de destino de la instalación de análisis forenses. Si el hecho de haber instalado o utilizado ooniprobe es un riesgo para usted, tenga en cuenta este peligro.
La versión más reciente de ooniprobe para las versiones de Debian y Ubuntu se puede encontrar en el repositorio de paquetes deb.torproject.org.
En Debian estable (jessie)::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org jessie main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
En Debian testing::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org testing main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
En Debian inestable::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org unstable main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
En Ubuntu 16.10 (yakkety), 16.04 (xenial) o 14.04 (trusty)::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org $RELEASE main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
Nota: Deberá reemplazar $RELEASE por yakkety, xenial o
trusty. Esto no ocurrirá automáticamente. También deberá asegurarse
de tener habilitado el repositorio universe. El repositorio universe
está habilitado por defecto en una instalación estándar de Ubuntu, pero puede que no lo esté en algunas instalaciones mínimas o no estándar.
Puede instalar ooniprobe en macOS si tiene instalado homebrew (http://brew.sh/) con::
brew install ooniprobe
Asegúrese de tener instaladas las siguientes dependencias:
Dependencias opcionales:
En sistemas basados en Debian, esto generalmente se puede hacer ejecutando::
sudo apt-get install -y build-essential libdumbnet-dev libpcap-dev libgeoip-dev libffi-dev python-dev python-pip tor libssl-dev obfs4proxy
Luego debería poder instalar ooniprobe ejecutando::
sudo pip install ooniprobe
o instalar ooniprobe como usuario::
pip install ooniprobe
Net test es un conjunto de mediciones para evaluar qué tipo de censura de Internet está ocurriendo.
Decks son colecciones de pruebas de red de ooniprobe con algunas entradas asociadas.
Collector es un servicio utilizado para informar los resultados de las mediciones.
Test helper es un servicio utilizado por una sonda para realizar correctamente sus mediciones.
Bouncer es un servicio utilizado para descubrir las direcciones de los test helpers y collectors.
Después de instalar ooniprobe correctamente, debería poder acceder a la interfaz web en su máquina local en http://localhost:8842/ después de ejecutar:: ooniprobe -w o iniciar el daemon.
Ahora debería ver el asistente de configuración de la interfaz web donde puede leer los riesgos asociados con la ejecución de ooniprobe. Al responder correctamente el cuestionario, puede habilitar o deshabilitar las pruebas de ooniprobe, establecer cómo conectarse al collector de mediciones y finalmente configurar sus ajustes de privacidad.
Por defecto, ooniprobe no incluirá información de identificación personal en los resultados de las pruebas, ni creará un archivo pcap. Este comportamiento se puede personalizar.
A partir de la versión 2.0.0 de ooniprobe, no es necesario usar cronjobs, ya que ooniprobe-agent es responsable de la programación de tareas.
Puede asegurarse de que ooniprobe-agent se ejecute siempre instalando y habilitando
la unidad de systemd ooniprobe.service::
wget https://raw.githubusercontent.com/TheTorProject/ooni-probe/master/scripts/systemd/ooniprobe.service --directory-prefix=/etc/systemd/system
systemctl enable ooniprobe
systemctl start ooniprobe