Wie installiere ich iperf3 auf meinem NAS?
Anwendbare Produkte
- All QNAP NAS models running QTS or QuTS hero system
- QTS 4.3.6 (or later), including QTS 5.x and QTS 6.x
- QuTS hero 4.5.0 (or later), including QuTS hero 5.x and QuTS hero 6.x
Übersicht
iPerf3 ist ein Open-Source-Tool zur Messung der Netzwerkleistung, das TCP/UDP-Bandbreite, Latenz und Paketverlust zwischen zwei Geräten misst.
Die Installation von iPerf3 auf einem QNAP NAS ermöglicht es dem NAS, direkt als Testendpunkt (Server oder Client) zu fungieren, was in den folgenden Szenarien nützlich ist:
- Netzwerk Durchsatz überprüfen: Bestätigen Sie, ob die tatsächliche Übertragungsgeschwindigkeit
zwischen dem NAS und einem Computer, Switch oder einem anderen Gerät den Erwartungen entspricht
(z.B. 1GbE, 10GbE). - Netzwerkleistungsprobleme diagnostizieren: Wenn die Zugriffsgeschwindigkeit auf das NAS
unerwartet langsam ist, verwenden Sie iPerf3, um festzustellen, ob der Engpass
in der Netzwerkschicht oder der Speicher-Schicht liegt. - Auswirkungen von Netzwerkänderungen bewerten: Vergleichen Sie
die tatsächliche Bandbreite vor und nach der Anpassung von Einstellungen wie MTU,
Jumbo-Frame, Port-Bündelung oder VLANs. - Hardware- oder Verkabelungsprobleme isolieren: Verwenden Sie Punkt-zu-Punkt-Tests
um zu überprüfen, ob ein Netzwerkadapter, Kabel oder Switch korrekt funktioniert
.
iPerf3 ist standardmäßig nicht in QTS oder QuTS hero integriert und muss separat installiert werden.
Lösung
iPerf3 kann auf einem QNAP NAS auf zwei Arten installiert werden: als Container in Container Station oder mit einer Entware QPKG-Datei.
Methode 1: iPerf3 in Container Station ausführen
-
Öffnen Sie den App Center, suchen Sie nach Container Station und installieren Sie es.
-
Beim ersten Start führen Sie den Einrichtungsassistenten durch und geben den Speicher-Speicherort für Containerdaten an.
-
Wählen Sie in Container Station Erstellen > Anwendung erstellen und geben Sie die folgende Docker Compose-Konfiguration ein:
services: iperf3: image: loganmarchione/docker-iperf3 container_name: iperf3 restart: unless-stopped ports: - "5201:5201/tcp" - "5201:5201/udp"Beziehen Sie sich auf die Dokumentation für das
loganmarchione/docker-iperf3-Image, um die unterstützten Umgebungsvariablen und Parameter zu erfahren. Um das NAS als iPerf3-Client statt als Server zu verwenden oder den Host-Netzwerkmodus für genauere Ergebnisse zu nutzen, passen Sie die Konfiguration entsprechend an. -
Klicken Sie auf Validieren, um die Korrektheit des YAML-Codes zu überprüfen.

-
Klicken Sie auf Erstellen und warten Sie, bis das Image heruntergeladen und der Container gestartet wird.
-
Bestätigen Sie, dass der Container-Status auf Running steht.

-
iPerf3 ist jetzt auf Ihrem NAS einsatzbereit.
Wenn eine Firewall oder Sicherheitsrichtlinie den Port 5201 blockiert, melden die Clients eine verweigerte Verbindung. Bestätigen Sie, dass der Port unter Systemsteuerung > System > Sicherheit nicht blockiert ist.
Methode 2: iPerf3 mit einer Entware QPKG-Datei installieren
-
Laden Sie
Entware_1.02std.qpkgvom QNAP-Download-Portal herunter. -
Installieren Sie die QPKG-Datei:
- Öffnen Sie den App Center
- Wählen Sie Manuell installieren
- Klicken Sie auf Durchsuchen und suchen Sie die heruntergeladene QPKG-Datei
- Klicken Sie auf Installieren

- Akzeptieren Sie das Risikoanerkennungsfeld und bestätigen Sie die Installation
- Überprüfen Sie, ob Entware-std 1.02 im App Center erscheint
-
Zugriff auf die NAS-Befehlszeile über eine SSH-Verbindung.
-
Navigieren Sie zum Entware-Installationsverzeichnis:
# cd /share/CACHEDEV1_DATA/.qpkg/Entware/binDer Volumenname in diesem Pfad variiert je nach Modell und Speicher-Konfiguration und unterscheidet sich auf QuTS hero-Systemen. Wenn das Verzeichnis nicht existiert, finden Sie es mit:
# ls -d /share/*/.qpkg/Entware/bin -
Führen Sie den Paketinstallationsbefehl aus:
# ./opkg install iperf3

6. iPerf3 ist jetzt auf Ihrem NAS einsatzbereit.

Benötigen Sie weitere Hilfe?
Stellen Sie Ihre Frage in der QNAP Community. QNAP-Mitarbeiter und erfahrene Anwender antworten Ihnen.