Zum Inhalt springen
SONOYA.com
Raspberry Pi & Linux

Heimnetz-Geschwindigkeit messen mit iperf3: LAN und WLAN

Mit iperf3 misst Du das Tempo zwischen zwei Geräten im Heimnetz, findest Engpässe bei LAN-Kabel, Repeater oder NAS und liest die Ausgabe richtig.

Von

Tachometer-Symbol auf dunkelrotem Verlauf als Sinnbild für die Messung der Datenrate zwischen zwei Geräten im Heimnetz mit iperf3

Das Kopieren auf den NAS dauert ewig, im Arbeitszimmer ruckelt der Stream, und der Speedtest im Browser sagt Dir nur, wie schnell Dein Internetanschluss ist. Ob das LAN-Kabel, der Repeater oder der NAS selbst bremst, verrät er nicht. Genau dafür gibt es iperf3: Das kleine Kommandozeilenwerkzeug misst die Heimnetz-Geschwindigkeit direkt zwischen zwei Geräten, ganz ohne Internet. Hier zeige ich Dir, wie Du iperf3 unter Linux und am Mac einrichtest, die Ausgabe richtig liest und Schritt für Schritt herausfindest, wo in Deinem Netz die Bandbreite verloren geht.

Warum iperf3 statt Speedtest

Ein Speedtest misst die ganze Strecke bis zu einem Server irgendwo im Internet. Das Ergebnis kann nie höher sein als Dein Anschluss, also sagt es über ein Gigabit-LAN zu Hause nichts aus. iperf3 arbeitet anders: Auf einem Gerät läuft ein Server, auf einem zweiten ein Client, und beide schicken sich so schnell wie möglich Daten zu. Gemessen wird nur die Strecke dazwischen, also Kabel, Switch, Router und WLAN. Weil iperf3 die Daten im Arbeitsspeicher erzeugt und verwirft, spielt auch die Festplatte keine Rolle.

Du brauchst zwei Geräte im selben Netz. Ideal als Server ist ein Gerät, das per Kabel am Router hängt, etwa ein Raspberry Pi 4 oder 5, ein Linux-Rechner oder ein selbst gebauter NAS. Der Client ist das Gerät, dessen Verbindung Du prüfen willst, zum Beispiel Dein MacBook im WLAN. Ein Raspberry Pi 3B+ taugt als Server nur bedingt, denn sein Gigabit-Port hängt intern am USB 2.0 und schafft laut Datenblatt von Raspberry Pi höchstens 300 Mbit/s.

Die Befehle, Ausgaben und Fehlermeldungen in dieser Anleitung sind getestet mit iperf3 3.18 aus den Paketquellen von Debian 13 Trixie, auf dem auch das aktuelle Raspberry Pi OS basiert, mit Server und Client in zwei getrennten Containern. Homebrew liefert am Mac derzeit die Version 3.22.1. Achte darauf, auf beiden Seiten iperf3 zu verwenden: Das ältere iperf2 ist laut den Entwicklern bewusst nicht kompatibel.

iperf3 installieren

Auf dem Raspberry Pi, unter Debian oder Ubuntu installierst Du iperf3 aus den Paketquellen:

Code
sudo apt update
sudo apt install iperf3

Während der Installation fragt Debian: „Iperf3 als Daemon automatisch starten?“ Wähl hier Nein. Für gelegentliche Messungen startest Du den Server lieber von Hand, dann lauscht er nicht dauerhaft im Netz.

Am Mac installierst Du iperf3 über Homebrew:

Code
brew install iperf3

Falls Homebrew noch fehlt, hilft Dir die Anleitung Homebrew auf dem Mac installieren: Anleitung für macOS 27 weiter. Ob alles geklappt hat, siehst Du auf beiden Geräten mit iperf3 --version.

Server und Client starten

Finde zuerst die IP-Adresse des Servers heraus. Auf einem Linux-Gerät zeigt sie Dir dieser Befehl:

Code
hostname -I

Die erste Adresse in der Ausgabe ist meist die richtige, in einem FRITZ!Box-Netz etwa 192.168.178.20. Jetzt startest Du auf dem Server iperf3 im Servermodus:

Code
iperf3 -s

Der Server meldet Server listening on 5201 und wartet. Er läuft so lange, bis Du ihn mit Strg + C beendest. Lass das Terminalfenster offen und wechsle zum Client. Dort startest Du die Messung:

Code
iperf3 -c 192.168.178.20

Ersetze 192.168.178.20 durch die IP-Adresse Deines Servers. Der Client sendet nun zehn Sekunden lang Daten an den Server und gibt jede Sekunde einen Zwischenstand aus.

Die Ausgabe richtig lesen

Die folgende Beispielausgabe stammt aus einem Testaufbau mit zwei Debian-13-Containern, deren Verbindung per Linux-Traffic-Control auf 1 Gbit/s gedrosselt war. Sie entspricht im Aufbau genau dem, was Du in Deinem Netz siehst. Die Zahlen sind Beispielwerte, die mittleren Sekundenzeilen sind gekürzt:

Code
Connecting to host iperf-srv, port 5201
[  5] local 172.19.0.3 port 60050 connected to 172.19.0.2 port 5201
[ ID] Interval           Transfer     Bitrate         Retr  Cwnd
[  5]   0.00-1.00   sec   114 MBytes   959 Mbits/sec    0    294 KBytes
[  5]   1.00-2.00   sec   114 MBytes   958 Mbits/sec    0    310 KBytes
...
[  5]   9.00-10.00  sec   114 MBytes   957 Mbits/sec    0    649 KBytes
- - - - - - - - - - - - - - - - - - - - - - - - -
[ ID] Interval           Transfer     Bitrate         Retr
[  5]   0.00-10.00  sec  1.11 GBytes   957 Mbits/sec    0            sender
[  5]   0.00-10.00  sec  1.11 GBytes   956 Mbits/sec                  receiver

iperf Done.

Entscheidend ist die letzte Zeile mit receiver. Sie zeigt, wie viele Daten tatsächlich beim Empfänger angekommen sind, hier 956 Mbit/s. Die Zeile sender darüber zählt, was losgeschickt wurde, und liegt meist minimal höher. Die übrigen Spalten bedeuten:

  • Transfer: die Datenmenge im jeweiligen Intervall, in Megabyte.
  • Bitrate: die Geschwindigkeit in Megabit pro Sekunde, also dieselbe Einheit wie bei Deinem Internettarif.
  • Retr: die Zahl der TCP-Pakete, die erneut gesendet werden mussten. Per Kabel sollte hier 0 oder ein sehr kleiner Wert stehen. Im WLAN sind einzelne Wiederholungen normal, ständig hohe Werte deuten auf Funkstörungen oder ein schwaches Signal hin.
  • Cwnd: das sogenannte Congestion Window, also wie viele Daten TCP gerade unbestätigt unterwegs haben darf. Für Deine Messung kannst Du diese Spalte ignorieren.

Schwanken die Sekundenwerte stark, etwa zwischen 200 und 600 Mbit/s, ist die Verbindung instabil. Das ist im WLAN typisch und per Kabel ein Warnzeichen.

Rückrichtung, längere Tests und parallele Streams

Ohne weitere Optionen sendet der Client und der Server empfängt. Bei Deinem Laptop entspricht das dem Upload. Den Download misst Du mit -R (Reverse), dann sendet der Server zum Client:

Code
iperf3 -c 192.168.178.20 -R

Im WLAN unterscheiden sich beide Richtungen oft deutlich, deshalb lohnt sich immer die zweite Messung. Weil die Werte im WLAN schwanken, verlängerst Du den Test mit -t auf 30 Sekunden und erhältst so einen verlässlicheren Mittelwert:

Code
iperf3 -c 192.168.178.20 -t 30

Eine einzelne TCP-Verbindung schöpft eine schnelle Leitung nicht immer aus. Mit -P 4 öffnet iperf3 vier parallele Streams:

Code
iperf3 -c 192.168.178.20 -P 4

Am Ende erscheint zusätzlich eine Zeile mit [SUM]. Sie zeigt die Gesamtrate aller Streams und ist der Wert, auf den Du schaust. Liegt die Summe deutlich über dem Einzelwert ohne -P, ist die Leitung schneller, als ein einzelner Stream zeigt. Bleibt sie gleich, ist die Leitung selbst die Grenze.

Welche Werte realistisch sind

Kein Netz erreicht die aufgedruckte Nennrate, denn ein Teil jeder Übertragung geht für Protokoll-Header drauf. Per Kabel kannst Du Dich an diesen Werten orientieren:

VerbindungNennrateTypischer iperf3-Wert
Fast Ethernet100 Mbit/setwa 94 Mbit/s
Gigabit-Ethernet1.000 Mbit/setwa 930 bis 945 Mbit/s
2,5-Gigabit-Ethernet2.500 Mbit/setwa 2.300 bis 2.350 Mbit/s

Der gedrosselte Containertest oben lag mit 956 Mbit/s etwas über diesem Bereich, weil die künstliche Drosselung anders zählt als eine echte Gigabit-Netzwerkkarte.

Im WLAN gibt es keinen festen Richtwert. Die Datenrate, die Dein Gerät als Verbindungsgeschwindigkeit anzeigt, ist eine Brutto-Rate. Als grobe Faustregel landet iperf3 bei etwa der Hälfte bis zwei Dritteln davon, mit jeder Wand und jedem weiteren aktiven Gerät weniger.

So grenzt Du den Engpass ein

Mit ein paar Messungen in fester Reihenfolge findest Du heraus, welches Glied der Kette bremst. Der Server bleibt dabei immer am selben Platz per Kabel am Router.

  1. Kabel neben Kabel: Schließ den Client per LAN-Kabel an denselben Router oder Switch an. Dieser Wert ist Deine Obergrenze. Erreichst Du hier keine rund 940 Mbit/s, liegt das Problem im Kabel, im Port oder im Netzwerkadapter.
  2. WLAN in Routernähe: Trenn das Kabel und miss im WLAN im selben Raum, einmal normal und einmal mit -R. Das ist das Beste, was Dein WLAN liefern kann.
  3. WLAN am Problemort: Wiederhole die Messung dort, wo es langsam ist. Ein großer Abfall gegenüber Schritt 2 heißt, dass Reichweite oder Repeater der Engpass sind.
  4. Netzwerk gegen Datenträger: Ist iperf3 zum NAS schnell, das Kopieren von Dateien aber langsam, bremst nicht das Netz, sondern die Festplatte, die Dateifreigabe oder die CPU des NAS.

Ein Wert von etwa 94 Mbit/s in Schritt 1 ist ein klassischer Befund: Irgendwo hat sich die Verbindung auf 100 Mbit/s ausgehandelt. Unter Linux siehst Du die ausgehandelte Geschwindigkeit mit cat /sys/class/net/eth0/speed, wobei 1000 für Gigabit steht. Schuld ist meist ein Kabel mit beschädigter Ader, eine schlecht aufgelegte Netzwerkdose oder ein alter Switch. Welche Kabelkategorie Du brauchst und wie Du eine Dose richtig auflegst, erklärt der Artikel LAN-Kabel Cat 5e bis Cat 8 erklärt und Dose anschließen. Hat Dein Laptop keine Netzwerkbuchse, brauchst Du für Schritt 1 einen USB-C-LAN-Adapter mit Gigabit (Affiliate Link).

Bricht das Tempo erst am Repeater ein, hilft Dir WLAN-Mesh mit der FRITZ!Box optimieren beim Umstellen auf eine LAN-Brücke und beim besseren Platzieren der Repeater. Und ist Dein Heimnetz in Ordnung, aber das Internet trotzdem langsam, geht es mit Internet zu langsam? Richtig messen und Minderung nutzen weiter, denn das ist eine Frage an Deinen Anbieter.

Wenn die Messung nicht startet

Die drei häufigsten Fehlermeldungen und was dahintersteckt:

  • unable to connect to server ... Connection refused: Auf dem Server läuft kein iperf3, oder Du hast mit -p einen anderen Port angegeben. Prüf, ob im Serverfenster noch Server listening on 5201 steht.
  • unable to connect to server ... No route to host oder eine Messung, die einfach hängen bleibt: Die IP-Adresse stimmt nicht, oder eine Firewall blockiert Port 5201. Läuft auf dem Server ufw, gibst Du den Port mit sudo ufw allow 5201/tcp frei und nach dem Test mit sudo ufw delete allow 5201/tcp wieder zu. Nutzt Du einen Mac als Server, prüf unter Systemeinstellungen > Netzwerk > Firewall, ob eingehende Verbindungen erlaubt sind.
  • the server is busy running a test. try again later: Ein iperf3-Server bedient immer nur eine Messung zur selben Zeit. Warte, bis der laufende Test fertig ist, und starte Deinen danach.

Bist Du fertig, beendest Du den Server mit Strg + C. Er hinterlässt nichts, was im Hintergrund weiterläuft.

Fazit

Mit zwei Befehlen hast Du eine ehrliche Zahl für jede Strecke in Deinem Heimnetz, unabhängig vom Internetanschluss. Die Messreihe von Kabel über WLAN in Routernähe bis zum Problemraum zeigt Dir in wenigen Minuten, ob Du ein neues Kabel, einen besser platzierten Repeater oder einen schnelleren NAS brauchst, statt auf Verdacht Hardware zu kaufen. Die vollständige Liste aller Optionen findest Du in der offiziellen iperf3-Dokumentation, den Quellcode und die Versionshinweise im GitHub-Repository esnet/iperf.

Weiterlesen.