iperf3 mide el rendimiento de una conexión entre dos equipos: uno actúa como servidor y el otro inicia la prueba como cliente. Permite generar tráfico TCP o UDP y observar el caudal que atraviesa el enlace. No mide la velocidad de Internet por sí solo: el resultado corresponde al trayecto entre esos dos puntos y depende de ambos equipos y de la red intermedia [1].
Instalar iperf3
Instala iperf3 en los dos equipos que participarán en la prueba. En Debian o Ubuntu:
sudo apt install iperf3
En macOS con Homebrew:
brew install iperf3
Homebrew publica la fórmula de iperf3 para macOS y Linux [2]. Comprueba que está disponible en cada equipo:
iperf3 --version
Preparar el servidor
En el equipo que recibirá la conexión, inicia el servidor:
iperf3 -s
Por defecto, el servidor escucha en el puerto TCP 5201. Si el firewall bloquea la conexión, permite el acceso a ese puerto desde la red de prueba; evita exponerlo a Internet sin una razón y controles adecuados [1].
Para utilizar otro puerto, indícalo en el servidor y también en el cliente:
iperf3 -s -p 5202
Medir el caudal TCP
Desde el equipo cliente, conecta con la dirección IP o el nombre del servidor:
iperf3 -c 192.0.2.10
La prueba TCP se ejecuta durante 10 segundos de forma predeterminada. El resultado muestra el volumen transferido y el caudal medio. Para cambiar la duración a 30 segundos:
iperf3 -c 192.0.2.10 -t 30
Para probar el sentido contrario —el servidor envía datos al cliente— añade -R:
iperf3 -c 192.0.2.10 -R
La dirección de la prueba importa: un enlace puede rendir de forma distinta en cada sentido. Si comparas equipos o cambios de configuración, conserva iguales la duración, el sentido y el resto de parámetros [1].
Medir con UDP
UDP permite observar caudal, jitter y pérdida de datagramas. Define una tasa objetivo con -b; evita comenzar con tasas cercanas a la capacidad máxima del enlace. Por ejemplo, para una prueba de 20 Mbit/s durante 10 segundos:
iperf3 -c 192.0.2.10 -u -b 20M -t 10 -i 1
-i 1 muestra un informe por segundo. En UDP, la tasa predeterminada es 1 Mbit/s; fija -b explícitamente para que la carga de la prueba sea conocida [1].
Precaución: una tasa UDP demasiado alta puede congestionar el enlace y afectar a otros usuarios. Aumenta el valor gradualmente y ejecuta la prueba solo en una red donde tengas autorización.
Qué revisar en el resultado
- Transfer: cantidad de datos enviados durante el intervalo.
- Bitrate: caudal medido. En TCP, compara el resultado con la capacidad del enlace y considera el tráfico concurrente.
- Jitter: variación temporal entre datagramas UDP.
- Lost/Total Datagrams: datagramas perdidos frente al total enviado en UDP.
Una prueba entre dos equipos no aísla por sí sola la causa de un resultado bajo. CPU, adaptadores, Wi-Fi, cableado, rutas, firewalls y tráfico de fondo pueden limitar el caudal. Repite las mediciones y registra sus parámetros antes de atribuir el resultado a un componente concreto.
Solucionar problemas de conexión
Si el cliente no conecta:
- Confirma que
iperf3 -ssigue ejecutándose en el servidor. - Comprueba que cliente y servidor pueden comunicarse por la red.
- Verifica la dirección, el puerto seleccionado y las reglas del firewall.
- Si usas un puerto personalizado, pasa el mismo valor con
-pal cliente.
Para consultar todas las opciones disponibles en la versión instalada:
iperf3 --help
