Community-Lösung

ZimaOS NETDEV WATCHDOG bei r8169: Einen Realtek-Netzwerk-Hänger diagnostizieren, bevor die Netzwerkkarte ersetzt wird

A November 2025 generic-PC ZimaOS 1.5.0 case where the server became unreachable and the console repeatedly logged r8169 NETDEV WATCHDOG transmit-queue timeouts. Community replies suspected the onboard Realtek NIC/driver and suggested an Intel I210 card. The original poster ordered one but never returned with a result, so the proposed replacement was not source-confirmed.

Die Konsolenmeldung zeigt eine Netzwerk-Sende-Warteschlange, die keine Fortschritte mehr machte:

r8169 ... eth0:
NETDEV WATCHDOG:
transmit queue 0 timed out

Das stimmt mit dem Symptom der Quelle überein: ZimaOS lief lokal weiter, während der Server über das Netzwerk nicht mehr erreichbar war. Die Community konzentrierte sich daher nachvollziehbar auf die Ebene von Netzwerkkarte, Treiber und Verbindung. Die Behauptung, der Linux- r8169 Der Treiber sei einfach „bekanntermaßen instabil“, ist zu pauschal, um daraus eine allgemeingültige ZimaOS-Schlussfolgerung abzuleiten.

Die ZimaOS-Konsole zeigte wiederholt r8169-NETDEV-WATCHDOG-Fehler mit „transmit queue 0 timed out“ an
Der Quellserver blieb lange genug aktiv, um wiederholt Watchdog-Meldungen auszugeben, während seine Ethernet-Verbindung keine normalen Übertragungen mehr durchführte.

Die Quellhardware verwendete eine ältere Gigabyte-AB350-Plattform

Das System bestand aus einem Ryzen 5 1600X auf einem Gigabyte AB350-Gaming 3 mit ZimaOS 1.5.0, wobei Jellyfin die einzige App war. Das Protokoll identifizierte den aktiven Ethernet-Treiber als r8169.

Bevor Sie diese Diagnose an anderer Stelle anwenden, ermitteln Sie die genaue Netzwerkkarte:

lspci -nnk | grep -A3 -i ethernet
ip link
dmesg | grep -i -E "r8169|eth0|watchdog|link"

Zuerst die physische Verbindung ausschließen

Eine Antwort aus der Community schlug richtigerweise vor, ein anderes Kabel und einen anderen Switch-/Router-Port auszuprobieren. Ein grenzwertiger PHY, ein fehlerhaftes Kabel, ein problematischer Stecker oder ein defekter Switch-Port kann Hänger/Resets verursachen, die wie ein Softwaretreiberfehler wirken.

ZimaOS aktualisieren, bevor ein NIC-Problem aus Version 1.5.0 reproduziert wird

Das aktuelle ZimaOS ist Version 1.7.1 und enthält umfangreiche Änderungen an Kernel, Treibern und Netzwerk nach der Veröffentlichung der Quelle. Reproduzieren Sie den Fehler zunächst im aktuellen stabilen Build, bevor Sie Ihre Lösung auf einem zwei Versionen alten Treiber-Stack aufbauen.

Die aktuelle IceWhale-Dokumentation unterstützt ausdrücklich mehrere Realtek-Netzwerkkarten

IceWhales aktuelle Kompatibilitätsliste umfasst Adapter mit RTL8111 und RTL8125/RTL8125B. Daher sollte die Aussage der Quelle aus der Community nicht verallgemeinert werden zu „Realtek wird unter ZimaOS nicht unterstützt.“

Verwenden Sie die aktuelle Liste der ZimaOS-Netzwerkadapter.

Der Austausch gegen eine Intel I210 wurde vorgeschlagen, aber nicht verifiziert

Der OP bestellte auf Empfehlung der Community eine Intel I210. Der Thread endet, bevor berichtet wird, ob das Problem mit dem Watchdog-Timeout dadurch behoben wurde.

Bezeichnen Sie I210 nicht als die durch die Quelle bestätigte Lösung. Wenn Sie heute Hardware ersetzen, wählen Sie eine Netzwerkkarte bzw. einen Chipsatz, der von der aktuellen Dokumentation unterstützt wird und zu den verfügbaren PCIe-Lanes Ihres Mainboards passt.

Keine r8168-Pakete wie unter Debian in den ZimaOS-Host installieren

Die Community schlug vor, Folgendes auszuprobieren r8168 stattdessen r8169. ZimaOS ist ein appliance-artiges, weitgehend schreibgeschütztes System und kein gewöhnlicher Debian-Host. Der Austausch von Treibern sollte über die unterstützte ZimaOS-Kernel-/Modulintegration erfolgen, nicht über willkürliche apt Anweisungen.

Änderungen an BIOS-Energiezuständen sind ein kontrollierter Test, keine Standardlösung

Das Deaktivieren von PCIe-Energiesparfunktionen/C-States wurde ebenfalls vorgeschlagen. Diese Einstellungen können auf einigen älteren Plattformen die Link-Stabilität beeinflussen, wirken sich jedoch auch auf den Leerlaufverbrauch und das Systemverhalten aus. Ändern Sie jeweils nur eine Einstellung und überprüfen Sie die langfristige Betriebszeit.

Link- und Treiberstatus vor dem Neustart erfassen

Wenn die Konsole weiterhin funktioniert, während das Netzwerk ausgefallen ist, erfassen Sie die Beweise vor dem Ausschalten und Wiedereinschalten:

ethtool eth0
ip -s link show eth0
dmesg | tail -200

Achten Sie auf Link-Flapping, Änderungen des Carrier-Status, Übertragungsfehler, Resets oder Watchdog-Meldungen. Ein Neustart kann die NIC vorübergehend wiederherstellen, löscht jedoch den zeitlichen Kontext, der dabei hilft, zwischen Treiber-, PHY-, Kabel- und Switch-Verhalten zu unterscheiden.

Jeweils nur eine Netzwerkkomponente ändern

Eine saubere Isolationsabfolge ist:

  1. das Ethernet-Kabel austauschen;
  2. zu einem anderen Port am Switch/Router wechseln;
  3. unnötige Energiesparfunktionen der NIC deaktivieren, sofern die Firmware dies ermöglicht;
  4. eine bekanntermaßen kompatible Erweiterungs-NIC testen;
  5. erst dann zu dem Schluss kommen, dass wahrscheinlich der Pfad über den Onboard-Adapter/Treiber die Ursache ist.

Wenn sich mehrere Variablen gleichzeitig ändern, zeigt ein stabiles Ergebnis nicht, welche Änderung ausschlaggebend war.

Das Vorhandensein von Jellyfin beweist nicht, dass der Medienserver den Watchdog verursacht hat

Auf der Quelle war Jellyfin installiert, aber die Watchdog-Meldung stammte vom Ethernet-Treiber und der Übertragungswarteschlange. Hoher Streaming-Datenverkehr kann dazu führen, dass ein grenzwertiger Netzwerkpfad früher ausfällt; die Deinstallation von Jellyfin würde jedoch kein defektes Kabel, keinen fehlerhaften PHY, Treiber oder eine PCIe-Energiesparinteraktion reparieren.

Generische x86-Unterstützung hängt weiterhin von den genauen Geräte-IDs ab

ZimaOS unterstützt generische x86-64-Hardware, aber keine Kompatibilitätsliste kann jede Mainboard-Revision, jeden NIC-PHY, jedes BIOS und jede Erweiterungskarte abdecken. Fügen Sie einem Supportbericht die genaue PCI-Hersteller-/Geräte-ID und die aktuelle ZimaOS-Version hinzu, damit IceWhale zwischen einem bekanntermaßen unterstützten Chipsatz und einem boardspezifischen Treiberproblem unterscheiden kann.

FAQ zum NETDEV-WATCHDOG

Bestätigte die Quelle, dass die Intel I210 das Problem behoben hat?

Nein. Der Benutzer hat die Karte bestellt, aber kein Ergebnis veröffentlicht.

Beweist der Fehler, dass jede r8169-/Realtek-NIC unter ZimaOS instabil ist?

Nein. Die aktuelle Kompatibilitätsdokumentation von IceWhale umfasst mehrere Realtek-NIC-Familien.

Was sollte vor dem Austausch der NIC getestet werden?

Aktuelles ZimaOS, ein anderes Kabel/einen anderen Port, die genaue Identifizierung von NIC/Treiber sowie Kernel-/Link-Protokolle während des Ausfalls.