--- title: "Cómo instalar y usar Speedtest CLI en Ubuntu 24.04 y Debian" description: "Instala Speedtest CLI de Ookla en Ubuntu 24.04 o Debian 12, mide la velocidad de tu servidor, elige el servidor de prueba y guarda los resultados en JSON." category: "Networking" language: es source: https://cubepath.com/es/docs/networking/como-instalar-y-ejecutar-speedtest updated: 2026-09-25 --- # Cómo instalar y usar Speedtest CLI en Ubuntu 24.04 y Debian Speedtest CLI es la versión de línea de comandos de Speedtest by Ookla. Mide la latencia, la velocidad de descarga y de subida y la pérdida de paquetes de tu servidor contra la red de servidores de Speedtest, sin necesidad de entorno gráfico. En este tutorial instalarás el cliente oficial en Ubuntu 24.04 (igual en Debian 12), ejecutarás una prueba, elegirás un servidor de prueba concreto y guardarás los resultados en un formato que puedas comparar más adelante. ## Requisitos previos Para seguir esta guía necesitas: - Un servidor con Ubuntu 24.04 LTS o Debian 12, x86_64 o arm64, por ejemplo un VPS o un servidor dedicado de CubePath. - Un usuario con privilegios `sudo`. - Salida a Internet por HTTPS (puerto 443) y por el puerto 8080, que usan los servidores de Speedtest. > Nota: Existe también un paquete `speedtest-cli` en los repositorios de Ubuntu, pero es un cliente no oficial escrito en Python que suele dar resultados menos precisos en conexiones rápidas. Esta guía usa el cliente oficial de Ookla, cuyo comando es `speedtest`. ## Paso 1: Descargar Speedtest CLI Ookla publica el cliente como un binario estático que funciona en cualquier distribución. Comprueba primero la arquitectura del servidor: ```bash uname -m ``` ```output x86_64 ``` Descarga el archivo que corresponde a tu arquitectura desde la web oficial de Ookla. Para `x86_64`: ```bash cd /tmp curl -fsSLO https://install.speedtest.net/app/cli/ookla-speedtest-1.2.0-linux-x86_64.tgz ``` Si `uname -m` devolvió `aarch64`, descarga en su lugar `ookla-speedtest-1.2.0-linux-aarch64.tgz` desde la misma ruta. Consulta en `https://www.speedtest.net/apps/cli` si hay una versión más reciente y ajusta el nombre del archivo. ## Paso 2: Instalar el binario Extrae solo el ejecutable del archivo y cópialo a `/usr/local/bin` con permisos de ejecución: ```bash tar -xzf ookla-speedtest-1.2.0-linux-x86_64.tgz speedtest sudo install -m 0755 speedtest /usr/local/bin/speedtest ``` Comprueba que el comando está disponible: ```bash speedtest --version ``` ```output Speedtest by Ookla 1.2.0.84 ... ``` Puedes borrar los archivos descargados: ```bash rm -f /tmp/ookla-speedtest-1.2.0-linux-x86_64.tgz /tmp/speedtest ``` ## Paso 3: Ejecutar la primera prueba La primera vez, el cliente pide aceptar la licencia de Ookla y el aviso de privacidad (GDPR). Puedes aceptarlos directamente con estas opciones, que también sirven para usarlo en scripts: ```bash speedtest --accept-license --accept-gdpr ``` La aceptación se guarda en `~/.config/ookla/`, así que las siguientes veces basta con `speedtest`. La prueba tarda unos 20 a 30 segundos: ```output Speedtest by Ookla Server: Adamo - Madrid (id: 1680) ISP: CubePath Idle Latency: 8.92 ms (jitter: 0.10ms, low: 8.82ms, high: 8.98ms) Download: 938.45 Mbps (data used: 1.1 GB) 9.01 ms (jitter: 1.95ms, low: 8.86ms, high: 31.79ms) Upload: 937.72 Mbps (data used: 819.2 MB) 12.62 ms (jitter: 0.43ms, low: 8.84ms, high: 13.52ms) Packet Loss: 0.0% Result URL: https://www.speedtest.net/result/c/068ae5b7-8013-41f3-a6c3-5c0b8be35aad ``` Cómo leer el resultado: - **Server**: el servidor de Speedtest contra el que se ha medido. El cliente elige por defecto uno cercano con baja latencia. - **Idle Latency**: la latencia con la conexión en reposo. Las dos líneas bajo `Download` y `Upload` son la latencia con la conexión cargada. - **Download / Upload**: el ancho de banda medido en cada sentido. - **Packet Loss**: el porcentaje de paquetes perdidos. En un servidor sano debería ser `0.0%`. - **Result URL**: un enlace público al resultado, útil para compartirlo. ## Paso 4: Elegir el servidor de prueba El resultado depende mucho del servidor remoto: uno saturado o lejano da cifras bajas aunque tu servidor esté bien. Lista los servidores cercanos: ```bash speedtest -L ``` ```output Closest servers: ID Name Location Country ============================================================================== 1680 Adamo Madrid Spain 14979 Orange Spain Madrid Spain ... ``` Lanza la prueba contra uno concreto con su ID: ```bash speedtest -s 14979 ``` Repetir la medición contra dos o tres servidores distintos ayuda a distinguir un problema de tu servidor de uno del servidor remoto. Para ver por qué el cliente eligió un servidor en la prueba automática, añade `--selection-details`. ## Paso 5: Guardar los resultados en JSON Para comparar mediciones a lo largo del tiempo o procesarlas con otras herramientas, usa el formato JSON. `-p no` desactiva la barra de progreso: ```bash speedtest -f json-pretty -p no ``` Extrae solo los valores que te interesan con `jq` (instálalo con `sudo apt install jq`). Los campos `bandwidth` están en bytes por segundo, así que se multiplican por 8 y se dividen entre 1.000.000 para obtener Mbps: ```bash speedtest -f json -p no | jq '{ping: .ping.latency, down_mbps: (.download.bandwidth * 8 / 1000000), up_mbps: (.upload.bandwidth * 8 / 1000000), loss: .packetLoss}' ``` ```output { "ping": 8.921, "down_mbps": 938.451, "up_mbps": 937.72, "loss": 0 } ``` Otros formatos disponibles con `-f` son `csv`, `tsv`, `jsonl` y `human-readable` (el predeterminado). ## Solución de problemas - **`Cannot read from socket` o `Configuration - Couldn't resolve host name`.** El servidor no tiene salida a Internet o no resuelve DNS. Comprueba con `ping -c 3 1.1.1.1` y `getent hosts www.speedtest.net`, y revisa las reglas de salida de tu cortafuegos. - **Velocidades muy por debajo de lo contratado.** Repite la prueba contra otros servidores (paso 4) y en otro momento del día. Comprueba también que ningún proceso está usando la red mientras mides, por ejemplo con `sudo apt install iftop` y `sudo iftop`. - **`speedtest: command not found`.** Revisa que `/usr/local/bin/speedtest` existe y es ejecutable. Si instalaste antes el paquete no oficial `speedtest-cli`, su comando es `speedtest-cli` y usa otras opciones. ## Conclusión Tienes el cliente oficial de Speedtest instalado y sabes medir contra servidores concretos y guardar los resultados en JSON. Si los resultados son bajos de forma persistente contra varios servidores, abre un ticket en el [soporte de CubePath](https://my.cubepath.com/tickets) e incluye los enlaces `Result URL` de las pruebas para que podamos revisarlo. Como siguiente paso, puedes medir el rendimiento entre dos servidores propios con `iperf3` o comprobar la ruta hasta un destino con `mtr`.