Solução da comunidade

ZimaOS NETDEV WATCHDOG no r8169: Diagnosticar um bloqueio de rede Realtek antes de substituir a placa de rede

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.

A mensagem da consola mostra uma fila de transmissão de rede que deixou de progredir:

r8169 ... eth0:
NETDEV WATCHDOG:
a fila de transmissão 0 excedeu o tempo limite

Isso é consistente com o sintoma da fonte — o ZimaOS continuava a funcionar localmente, enquanto o servidor ficava inacessível através da rede. A comunidade concentrou-se razoavelmente na camada da placa de rede/controlador/ligação, mas a afirmação de que o controlador Linux r8169 é simplesmente “conhecido por ser instável” é uma afirmação demasiado abrangente para ser mantida como conclusão universal sobre o ZimaOS.

A consola do ZimaOS apresentava repetidamente erros de tempo limite da fila de transmissão 0 do NETDEV WATCHDOG do r8169
O servidor de origem continuou suficientemente operacional para apresentar mensagens repetidas do watchdog, enquanto o respetivo percurso Ethernet tinha deixado de transmitir normalmente.

O hardware da fonte utilizava uma plataforma Gigabyte AB350 mais antiga

O sistema utilizava um Ryzen 5 1600X numa Gigabyte AB350-Gaming 3 com o ZimaOS 1.5.0, tendo o Jellyfin como única aplicação. O registo identificou o controlador Ethernet ativo como r8169.

Antes de aplicar este diagnóstico noutro contexto, identifique a placa de rede exata:

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

Primeiro, exclua a ligação física

Uma resposta da comunidade sugeriu corretamente experimentar outro cabo e outra porta do switch/router. Um PHY, cabo, conector ou porta do switch marginal pode causar bloqueios/reinícios que parecem resultar de uma falha do controlador de software.

Atualize o ZimaOS antes de reproduzir um problema de placa de rede da versão 1.5.0

A versão atual do ZimaOS é a 1.7.1 e inclui alterações substanciais ao kernel, aos controladores e à rede posteriores à versão da fonte. Reproduza a falha na versão estável atual antes de conceber uma solução baseada numa pilha de controladores com duas versões de atraso.

A documentação atual da IceWhale suporta explicitamente várias placas de rede Realtek

A lista de compatibilidade atual da IceWhale inclui adaptadores RTL8111 e RTL8125/RTL8125B. Por conseguinte, a afirmação da comunidade na fonte não deve ser generalizada para “a Realtek não é compatível com o ZimaOS”.

Utilize a lista atual de adaptadores de rede do ZimaOS.

A substituição pelo Intel I210 foi sugerida, não verificada

O autor original encomendou um Intel I210 após a recomendação da comunidade. O tópico termina antes de indicar se resolveu o tempo limite do watchdog.

Não classifique o I210 como a solução confirmada pela fonte. Se for substituir o hardware atualmente, escolha uma placa de rede/chipset compatível com a documentação atual e com as pistas PCIe disponíveis na sua motherboard.

Não instale pacotes r8168 no anfitrião ZimaOS como faria no Debian

A comunidade sugeriu experimentar r8168 em vez de r8169. O ZimaOS é um sistema de estilo appliance, em grande parte apenas de leitura, e não um anfitrião Debian normal. A substituição do controlador deve ser feita através da integração suportada de kernel/módulos do ZimaOS, e não de forma arbitrária apt instruções.

Alterações aos estados de energia da BIOS são um teste controlado, não uma correção predefinida

Também foi sugerido desativar a poupança de energia PCIe/os estados C. Essas definições podem afetar a estabilidade da ligação em algumas plataformas mais antigas, mas também afetam o consumo em inatividade e o comportamento do sistema. Altere uma definição de cada vez e verifique o tempo de funcionamento a longo prazo.

Recolher o estado da ligação e do controlador antes de reiniciar

Se a consola continuar a funcionar enquanto a rede estiver inoperacional, recolha as provas antes de desligar e voltar a ligar a alimentação:

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

Procure perdas de ligação, alterações do estado do suporte, erros de transmissão, reinicializações ou mensagens do watchdog. Uma reinicialização pode restaurar temporariamente a NIC, mas elimina o contexto temporal que ajuda a distinguir o comportamento do controlador, do PHY, do cabo e do switch.

Alterar um componente de rede de cada vez

Uma sequência de isolamento adequada é:

  1. substituir o cabo Ethernet;
  2. mudar para outra porta do switch/router;
  3. desativar funcionalidades desnecessárias de poupança de energia da NIC, se o firmware as disponibilizar;
  4. testar uma NIC de expansão conhecida como compatível;
  5. só então concluir que o percurso do adaptador/controlador integrado é provavelmente a causa da falha.

Se várias variáveis forem alteradas em simultâneo, um resultado estável não revela qual foi a alteração relevante.

A presença do Jellyfin não prova que o servidor multimédia causou o watchdog

A fonte tinha o Jellyfin instalado, mas a mensagem do watchdog vinha do controlador Ethernet e da fila de transmissão. Um tráfego intenso de streaming pode fazer com que um percurso de rede marginal falhe mais depressa, mas desinstalar o Jellyfin não repararia um cabo, PHY, controlador ou interação de estados de energia PCIe defeituosos.

O suporte x86 genérico continua a depender dos IDs exatos dos dispositivos

O ZimaOS suporta hardware x86-64 genérico, mas nenhuma lista de compatibilidade pode abranger todas as revisões de placas-mãe, PHYs de NIC, BIOS e placas de expansão. Inclua o ID exato do fornecedor/dispositivo PCI e a versão atual do ZimaOS num relatório de suporte, para que a IceWhale possa distinguir um chipset oficialmente suportado de um problema de controlador específico da placa.

FAQ do NETDEV WATCHDOG

A fonte confirmou que a Intel I210 resolveu o problema?

Não. O utilizador encomendou a placa, mas não publicou nenhum resultado.

O erro prova que todas as NIC r8169/Realtek são instáveis no ZimaOS?

Não. A documentação atual de compatibilidade da IceWhale inclui várias famílias de NIC Realtek.

O que deve ser testado antes de substituir a NIC?

Versão atual do ZimaOS, outro cabo/porta, identificação exata da NIC/do controlador e registos do kernel/da ligação durante a falha.