← retour aux snippets

iperf3: mesurer la bande passante réseau

Tester débit TCP/UDP entre deux hôtes: serveur, client, flux parallèles, reverse et sortie JSON.

objectif

Évaluer la bande passante réelle entre deux machines, détecter goulots d’étranglement et vérifier la QoS.

code minimal

# sur le serveur (écoute par défaut sur 5201)
iperf3 -s

# exécuter un seul test puis quitter
iperf3 -s -1

# sur le client (test TCP 10 secondes)
iperf3 -c SERVEUR -t 10

# test reverse (trafic du serveur vers le client)
iperf3 -c SERVEUR -t 10 -R

utilisation

# saturer mieux le lien avec 4 flux parallèles
iperf3 -c SERVEUR -P 4 -t 15

# préciser l'interface source (multi-homed)
iperf3 -c SERVEUR -B 192.0.2.10 -P 4 -t 15

# mode UDP à débit cible (mesure perte/jitter)
iperf3 -u -b 200M -c SERVEUR -t 10

# sortie JSON pour ingestion (logs/graphes)
iperf3 -c SERVEUR -P 4 -t 10 -J > iperf3.json

variante(s) utile(s)

# changer de port (ouvrir côté serveur aussi)
iperf3 -s -p 5205
iperf3 -c SERVEUR -p 5205 -P 4 -t 10

# limiter le CPU client/serveur pour tests comparables
taskset -c 0-1 iperf3 -c SERVEUR -P 4 -t 20

# test UDP "illimité" (peut surcharger réseaux/CPU; prudence)
iperf3 -u -b 0 -c SERVEUR -t 10

notes

  • assurez-vous d’avoir l’autorisation et les ports ouverts (firewall/NAT).
  • TCP est limité par la fenêtre/RWIN/latence; multipliez les flux (-P) pour mieux remplir les liens à RTT élevés.
  • en UDP, ajustez -b selon la capacité; surveillez pertes et jitter.