Communityoplossing

ZimaOS NETDEV WATCHDOG op r8169: Diagnoseer een Realtek-netwerkblokkering voordat je de NIC vervangt

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.

De consolemelding toont een netwerkverzendwachtrij die geen voortgang meer boekte:

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

Dat komt overeen met het symptoom uit de bron: ZimaOS bleef lokaal draaien, terwijl de server via het netwerk onbereikbaar werd. De community richtte zich redelijkerwijs op de NIC-/driver-/verbindingslaag, maar de bewering dat de Linux r8169 De bewering dat de driver simpelweg “bekend instabiel” is, is te algemeen om als universele ZimaOS-conclusie te handhaven.

De ZimaOS-console toonde herhaaldelijk fouten met de melding r8169 NETDEV WATCHDOG transmit queue 0 timed out
De bronserver bleef lang genoeg actief om herhaaldelijk watchdogmeldingen af te drukken, terwijl het Ethernetpad niet meer normaal gegevens verzond.

De bronhardware gebruikte een ouder Gigabyte AB350-platform

Het systeem was een Ryzen 5 1600X op een Gigabyte AB350-Gaming 3 waarop ZimaOS 1.5.0 draaide, met Jellyfin als enige app. Het log identificeerde de actieve Ethernetdriver als r8169.

Voordat u deze diagnose elders toepast, moet u de exacte NIC identificeren:

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

Sluit eerst de fysieke verbinding uit

Een communityreactie stelde terecht voor om een andere kabel en een andere poort op de switch/router te proberen. Een marginale PHY, kabel, connector of switchpoort kan vastlopers en resets veroorzaken die lijken op een fout in de softwaredriver.

Werk ZimaOS bij voordat u een NIC-probleem uit versie 1.5.0 reproduceert

De huidige versie van ZimaOS is 1.7.1 en bevat aanzienlijke kernel-, driver- en netwerkwijzigingen na de release van de bron. Reproduceer de fout op de huidige stabiele versie voordat u uw ontwerp baseert op een twee versies oude driverstack.

De huidige documentatie van IceWhale ondersteunt expliciet verschillende Realtek-NIC's

De huidige compatibiliteitslijst van IceWhale bevat RTL8111- en RTL8125/RTL8125B-adapters. Daarom mag de community-uitspraak uit de bron niet worden veralgemeend tot “Realtek wordt niet ondersteund op ZimaOS.”

Gebruik de huidige lijst met ZimaOS-netwerkadapters.

De vervanging door een Intel I210 werd voorgesteld, maar niet geverifieerd

De OP bestelde een Intel I210 na de aanbeveling van de community. De thread eindigt voordat die meldt of het probleem met de watchdog-time-out daarmee is opgelost.

Bestempel de I210 niet als de door de bron bevestigde oplossing. Als u vandaag hardware vervangt, kies dan een NIC/chipset die door de huidige documentatie wordt ondersteund en past bij de beschikbare PCIe-lanes van uw moederbord.

Installeer geen r8168-pakketten in de ZimaOS-host zoals in Debian

De community stelde voor om het te proberen r8168 in plaats van r8169. ZimaOS is een appliance-achtig, grotendeels alleen-lezen systeem en geen normale Debian-host. Driververvanging moet worden geleverd via ondersteunde ZimaOS-kernel-/module-integratie, niet via willekeurige apt instructies.

Wijzigingen in BIOS-energiestatus zijn een gecontroleerde test, geen standaardoplossing

Het uitschakelen van PCIe-energiebesparing/C-states werd ook voorgesteld. Deze instellingen kunnen op sommige oudere platforms de linkstabiliteit beïnvloeden, maar hebben ook invloed op het energieverbruik in rust en het systeemgedrag. Wijzig telkens één instelling en controleer de uptime op lange termijn.

Leg de link- en driverstatus vast voordat je opnieuw opstart

Als de console nog werkt terwijl het netwerk niet beschikbaar is, verzamel dan het bewijs voordat je de stroom uitschakelt:

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

Let op linkflaps, carrierwijzigingen, transmissiefouten, resets of watchdogmeldingen. Een herstart kan de NIC tijdelijk herstellen, maar wist de tijdscontext die helpt onderscheid te maken tussen driver-, PHY-, kabel- en switchgedrag.

Wijzig telkens slechts één netwerkcomponent

Een goede isolatiesequentie is:

  1. vervang de Ethernetkabel;
  2. gebruik een andere poort op de switch/router;
  3. schakel onnodige energiebesparingsfuncties van de NIC uit als de firmware deze beschikbaar stelt;
  4. test een bekende compatibele uitbreidings-NIC;
  5. concludeer pas dan dat het onboard-adapter-/driverpad waarschijnlijk de oorzaak is.

Als meerdere variabelen tegelijk veranderen, laat een stabiel resultaat niet zien welke verandering het verschil maakte.

De aanwezigheid van Jellyfin bewijst niet dat de mediaserver de watchdog heeft veroorzaakt

Op het systeem uit de bron was Jellyfin geïnstalleerd, maar de watchdogmelding kwam van de Ethernet-driver en de verzendwachtrij. Zwaar streamingverkeer kan ervoor zorgen dat een marginale netwerkverbinding eerder uitvalt, maar het verwijderen van Jellyfin zou een defecte kabel, PHY, driver of PCIe-energiebeheerinteractie niet repareren.

Generieke x86-ondersteuning hangt nog steeds af van exacte apparaat-ID's

ZimaOS ondersteunt generieke x86-64-hardware, maar geen enkele compatibiliteitslijst kan elke revisie van een moederbord, NIC PHY, BIOS en uitbreidingskaart omvatten. Vermeld de exacte PCI-leveranciers-/apparaat-ID en de huidige ZimaOS-versie in een supportmelding, zodat IceWhale onderscheid kan maken tussen een bekende ondersteunde chipset en een boardspecifiek driverprobleem.

Veelgestelde vragen over NETDEV WATCHDOG

Heeft de bron bevestigd dat de Intel I210 het probleem heeft opgelost?

Nee. De gebruiker heeft de kaart besteld, maar geen resultaat geplaatst.

Bewijst de fout dat elke r8169/Realtek-NIC instabiel is op ZimaOS?

Nee. De huidige compatibiliteitsdocumentatie van IceWhale bevat verschillende Realtek-NIC-families.

Wat moet worden getest voordat de NIC wordt vervangen?

Huidige ZimaOS-versie, een andere kabel/poort, de exacte identificatie van NIC/driver en kernel-/linklogboeken tijdens de storing.