Soluzione della community

ZimaOS NETDEV WATCHDOG su r8169: diagnosticare un blocco della rete Realtek prima di sostituire la scheda di rete

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.

Il messaggio della console mostra una coda di trasmissione di rete che ha smesso di avanzare:

r8169 ... eth0:
NETDEV WATCHDOG:
la coda di trasmissione 0 è scaduta

Questo è coerente con il sintomo della fonte: ZimaOS continuava a funzionare localmente mentre il server diventava irraggiungibile tramite rete. La community si è concentrata ragionevolmente sul livello scheda di rete/driver/collegamento, ma l'affermazione secondo cui il driver Linux r8169 affermare semplicemente che il driver è “noto per essere instabile” è troppo generico per essere esteso come conclusione universale su ZimaOS.

La console di ZimaOS mostrava ripetutamente errori r8169 NETDEV WATCHDOG transmit queue 0 timed out
Il server nella fonte è rimasto abbastanza operativo da mostrare ripetuti messaggi del watchdog mentre il percorso Ethernet aveva smesso di trasmettere normalmente.

L'hardware del server nella fonte utilizzava una piattaforma Gigabyte AB350 più datata

Il sistema era un Ryzen 5 1600X su una Gigabyte AB350-Gaming 3 con ZimaOS 1.5.0, con Jellyfin come unica app. Il log identificava il driver Ethernet attivo come r8169.

Prima di applicare questa diagnosi altrove, identifica la scheda di rete esatta:

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

Prima escludi un problema del collegamento fisico

Una risposta della community ha correttamente suggerito di provare un altro cavo e un'altra porta dello switch o del router. Un livello PHY, un cavo, un connettore o una porta dello switch difettosi possono causare blocchi o ripristini che sembrano dovuti a un errore del driver software.

Aggiorna ZimaOS prima di riprodurre un problema della scheda di rete su ZimaOS 1.5.0

L'attuale ZimaOS è la versione 1.7.1 e include importanti modifiche al kernel, ai driver e alla rete successive alla pubblicazione della fonte. Riproduci il problema sulla versione stabile attuale prima di progettare una soluzione basata su uno stack di driver vecchio di due versioni.

L'attuale documentazione di IceWhale supporta esplicitamente diverse schede di rete Realtek

L'attuale elenco di compatibilità di IceWhale include schede RTL8111 e RTL8125/RTL8125B. Pertanto, l'affermazione della community nella fonte non dovrebbe essere generalizzata in “Realtek non è supportata su ZimaOS”.

Usa l'elenco attuale delle schede di rete compatibili con ZimaOS.

La sostituzione con Intel I210 è stata suggerita, non verificata

L'autore del post ha ordinato una Intel I210 dopo la raccomandazione della community. La discussione termina prima che riferisca se il problema del watchdog timeout sia stato risolto.

Non indicare I210 come soluzione confermata dalla fonte. Se oggi sostituisci l'hardware, scegli una scheda di rete o un chipset supportato dalla documentazione attuale e dalle linee PCIe disponibili sulla scheda madre.

Non installare i pacchetti r8168 nell'host ZimaOS come su Debian

La community ha suggerito di provare r8168 invece di r8169. ZimaOS è un sistema di tipo appliance, in gran parte di sola lettura, non un normale host Debian. La sostituzione del driver dovrebbe avvenire tramite l’integrazione supportata del kernel/modulo di ZimaOS, non tramite apt istruzioni.

Le modifiche agli stati di alimentazione del BIOS sono un test controllato, non una soluzione predefinita

È stato suggerito anche di disabilitare il risparmio energetico PCIe/C-state. Queste impostazioni possono influire sulla stabilità del collegamento su alcune piattaforme meno recenti, ma influiscono anche sul consumo a riposo e sul comportamento del sistema. Modifica un’impostazione alla volta e verifica l’operatività a lungo termine.

Acquisisci lo stato del collegamento e del driver prima del riavvio

Se la console continua a funzionare mentre la rete è inattiva, raccogli le prove prima di spegnere e riaccendere il sistema:

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

Cerca interruzioni del collegamento, cambiamenti dello stato del carrier, errori di trasmissione, ripristini o messaggi del watchdog. Un riavvio può ripristinare temporaneamente la scheda di rete, ma cancella il contesto temporale utile a distinguere il comportamento del driver, del PHY, del cavo e dello switch.

Cambia un solo componente di rete alla volta

Una sequenza di isolamento corretta è:

  1. sostituisci il cavo Ethernet;
  2. sposta il collegamento su un’altra porta dello switch/router;
  3. disabilita le funzioni non necessarie di risparmio energetico della scheda di rete, se il firmware le espone;
  4. prova una scheda di rete aggiuntiva nota come compatibile;
  5. solo allora concludi che il percorso della scheda di rete integrata/del driver è probabilmente la causa del guasto.

Se più variabili cambiano contemporaneamente, un risultato stabile non rivela quale cambiamento abbia avuto effetto.

La presenza di Jellyfin non dimostra che il server multimediale abbia causato il watchdog

La fonte aveva Jellyfin installato, ma il messaggio del watchdog proveniva dal driver Ethernet e dalla coda di trasmissione. Un traffico di streaming intenso può far emergere prima un problema marginale del percorso di rete, ma disinstallare Jellyfin non riparerebbe un cavo, un PHY, un driver o un’interazione relativa agli stati di alimentazione PCIe difettosi.

Il supporto x86 generico dipende ancora dagli ID esatti del dispositivo

ZimaOS supporta hardware x86-64 generico, ma nessun elenco di compatibilità può coprire ogni revisione della scheda madre, PHY della scheda di rete, BIOS e scheda aggiuntiva. Includi nel rapporto di supporto l’ID esatto del fornitore/dispositivo PCI e la versione attuale di ZimaOS, così IceWhale può distinguere un chipset noto come supportato da un problema di driver specifico della scheda.

FAQ su NETDEV WATCHDOG

La fonte ha confermato che la Intel I210 ha risolto il problema?

No. L’utente ha ordinato la scheda, ma non ha pubblicato alcun risultato.

L’errore dimostra che ogni scheda di rete r8169/Realtek è instabile su ZimaOS?

No. La documentazione attuale sulla compatibilità di IceWhale include diverse famiglie di schede di rete Realtek.

Cosa dovrebbe essere verificato prima di sostituire la scheda di rete?

ZimaOS attuale, un altro cavo/porta, l’identificazione esatta della scheda di rete/del driver e i log del kernel/del collegamento durante il guasto.