
Motor de medición y CLI en Go para detectar censura en Internet e interferencias de red, ejecutar pruebas de red OONI y reportar resultados al observatorio abierto.
Instrucciones de instalación »
Guía del usuario · Documentación de la API · Informar de un error · Solicitar una función · Tutoriales
El Open Observatory of Network Interference (OONI) es un proyecto de software libre sin fines de lucro que tiene como objetivo empoderar los esfuerzos descentralizados para documentar la censura de Internet en todo el mundo.
Este repositorio contiene los siguientes paquetes de Go:
el cliente de línea de comandos ooniprobe (cmd/ooniprobe);
el servidor de ayuda para pruebas (internal/cmd/oohelperd);
la biblioteca móvil (pkg/oonimkall);
la biblioteca del motor de medición (internal);
el cliente de línea de comandos experimental miniooni (internal/cmd/miniooni).
Cada directorio de nivel superior en este repositorio contiene un archivo README explicativo.
Sigue las instrucciones en ooni.org/install/cli
para instalar los binarios precompilados de ooniprobe para Windows, macOS y
Debian/Ubuntu. Una vez que ooniprobe esté instalado, consulta la
guía del usuario.
Publicamos compilaciones nocturnas usando la etiqueta de versión continua. Estas
compilaciones usan el último commit de la rama master.
Para configurar el desarrollo de este repositorio necesitas Go >= 1.15. El
script ./script/go.bash descargará automáticamente la versión esperada
de Go mencionada en el archivo GOVERSION (es decir,
go1.27.3) y la usará para compilar.
También puedes omitir ./script/go.bash y compilar ooniprobe manualmente usando
go build ... pero, en tal caso, ten en cuenta que:
usar una versión anterior a la mencionada en GOVERSION definitivamente no es recomendable y puede que ni siquiera compile;
usar versiones posteriores debería funcionar según lo previsto para la funcionalidad principal pero la funcionalidad adicional puede estar deshabilitada o no funcionar según lo previsto.
He aquí por qué: dependemos de paquetes bifurcados de la biblioteca estándar; por lo tanto, es más robusto usar la misma versión de Go de la cual bifurcamos esos paquetes.
También necesitarás un compilador de C. En Linux y otros sistemas Unix tanto GCC como Clang funcionarán. Si estás usando Windows, te recomendamos instalar Ubuntu o Debian en el Subsistema de Windows para Linux. Si tu objetivo es Windows, también deberías instalar el compilador cruzado mingw-w64.
Los siguientes comandos muestran cómo configurar un entorno de desarrollo usando Debian 12 ("bookworm"). Las mismas instrucciones también deberían funcionar para Ubuntu 22.04 LTS.
# install the compilers, git, and the root CA
sudo apt install golang build-essential ca-certificates git
# [optional] install mingw-w64 if you're targeting windows
sudo apt install mingw-w64
Los siguientes comandos muestran cómo configurar un entorno de desarrollo usando Fedora, siempre que tu Fedora use Go >= 1.15.
# install the compilers and git
sudo dnf install golang make gcc gcc-c++ git
# [optional] install mingw-w64 if you're targeting windows
sudo dnf install mingw64-gcc mingw64-gcc-c++
Los siguientes comandos muestran cómo configurar un entorno de desarrollo usando macOS. Asumimos que ya has instalado Homebrew, que también debería instalar las herramientas de línea de comandos de Xcode.
A continuación, debes seguir estas instrucciones:
# install the compiler
brew install go
./script/go.bashEl script ./script/go.bash requiere Go >= 1.15 y automatiza la instalación y
el uso de la versión correcta de Go. Ejecutar este script de la siguiente manera:
./script/go.bash build -v -ldflags '-s -w' ./internal/cmd/miniooni
Es equivalente a ejecutar estos comandos:
go install -v golang.org/dl/go1.27.3@latest
$HOME/go/bin/go1.27.3 download
export GOTOOLCHAIN=local
$HOME/sdk/go1.27.3/bin/go build -v -ldflags '-s -w' ./internal/cmd/miniooni
Esta sección muestra cómo compilar usando ./script/go.bash. Si quieres omitir
el uso de este script, simplemente ejecuta go en lugar de ./script/go.bash.
Puedes compilar ooniprobe usando:
./script/go.bash build -v -ldflags '-s -w' ./cmd/ooniprobe
Este comando generará un binario reducido llamado ooniprobe
en el directorio de nivel superior.
De igual manera, puedes compilar miniooni usando:
./script/go.bash build -v -ldflags '-s -w' ./internal/cmd/miniooni
Este comando generará un binario reducido llamado miniooni
en el directorio de nivel superior.
Y oohelperd usando:
./script/go.bash build -v -ldflags '-s -w' ./internal/cmd/oohelperd
Este comando generará un binario reducido llamado oohelperd
en el directorio de nivel superior.