コミュニティソリューション

NICを交換する前に、r8169で発生するZimaOS NETDEV WATCHDOGを診断:Realtekネットワークのハングアップを解決する

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.

コンソールメッセージは、ネットワーク送信キューが進行を停止したことを示しています。

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

これは、ネットワーク経由ではサーバーに接続できなくなった一方で、ZimaOS自体はローカルで動作し続けたという原文の症状と一致します。コミュニティがNIC、ドライバー、リンク層に注目したのは妥当ですが、Linuxの問題が r8169 ドライバーが単に「不安定であることが知られている」とするのは広すぎ、ZimaOS全体に普遍的に当てはまる結論として引き継ぐことはできません。

ZimaOSのコンソールにr8169 NETDEV WATCHDOG transmit queue 0 timed outエラーが繰り返し表示される
原文のサーバーは、Ethernet経路が正常な送信を停止した後も、ウォッチドッグメッセージを繰り返し出力できる程度には稼働し続けていました。

原文のハードウェアは旧世代のGigabyte AB350プラットフォームを使用していました

システムはGigabyte AB350-Gaming 3でZimaOS 1.5.0を実行するRyzen 5 1600Xで、アプリはJellyfinのみでした。ログでは、アクティブなEthernetドライバーが次のように特定されました。 r8169.

この診断を別の環境に適用する前に、正確なNICを特定してください。

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

まず物理リンクを除外する

コミュニティの返信では、別のケーブルと別のスイッチ/ルーターのポートを試すよう適切に提案していました。PHY、ケーブル、コネクター、またはスイッチポートの状態が不安定だと、ソフトウェアドライバーの障害に見えるハングやリセットが発生することがあります。

ZimaOSを更新してから1.5.0のNIC問題を再現する

現在のZimaOSは1.7.1であり、原文のリリース後にカーネル、ドライバー、ネットワークに大幅な変更が加えられています。2世代前のドライバースタックを前提に設計する前に、現在の安定版ビルドで障害を再現してください。

現在のIceWhaleドキュメントでは複数のRealtek NICが明示的にサポートされています

IceWhaleの現在の互換性リストには、RTL8111およびRTL8125/RTL8125Bアダプターが含まれています。したがって、原文にあるコミュニティの発言を「RealtekはZimaOSでサポートされていない」と一般化すべきではありません。

現在のZimaOSネットワークアダプター一覧を使用してください。

Intel I210への交換は提案されたものであり、検証済みではありません

OPはコミュニティの推奨を受けてIntel I210を注文しました。スレッドは、これでウォッチドッグタイムアウトが解決したかどうかを報告する前に終了しています。

I210を根拠が確認された解決策として扱わないでください。現在ハードウェアを交換する場合は、最新のドキュメントとマザーボードで利用可能なPCIeレーンに対応したNIC/チップセットを選択してください。

DebianのようにZimaOSホストへr8168パッケージをインストールしないでください

コミュニティは試してみることを提案しました r8168 ではなく r8169。ZimaOS は通常の Debian ホストではなく、アプライアンス型で、ほぼ読み取り専用のシステムです。ドライバーの交換は、任意の apt 手順。

BIOS の電源状態変更は、既定の修正方法ではなく、制御されたテストです

PCIe の省電力機能/C-states を無効にすることも提案されました。これらの設定は一部の古いプラットフォームでリンクの安定性に影響する可能性がありますが、アイドル時の消費電力やシステムの挙動にも影響します。一度に 1 つの設定だけを変更し、長期的な稼働時間を確認してください。

再起動前にリンクとドライバーの状態を記録する

コンソールが引き続き使用でき、ネットワークだけが停止している場合は、電源を入れ直す前に証拠を収集してください。

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

リンクの断続、キャリア状態の変化、送信エラー、リセット、または watchdog メッセージを確認します。再起動すると NIC が一時的に復旧することがありますが、ドライバー、PHY、ケーブル、スイッチの挙動を区別するのに役立つ時間的状況が失われます。

ネットワークコンポーネントは一度に 1 つだけ変更する

切り分けの手順は次のとおりです。

  1. Ethernet ケーブルを交換する。
  2. 別のスイッチ/ルーターのポートに移す。
  3. ファームウェアに設定項目がある場合は、不要な NIC の省電力機能を無効にする。
  4. 互換性が確認された増設 NIC をテストする。
  5. その後で初めて、オンボードアダプター/ドライバー経路が原因である可能性が高いと結論付けます。

複数の変数を同時に変更した場合、結果が安定しても、どの変更が効果をもたらしたのかは分かりません。

Jellyfin が存在していても、メディアサーバーが watchdog の原因だったとは証明できません

情報源には Jellyfin がインストールされていましたが、watchdog メッセージは Ethernet ドライバーと送信キューから発生していました。大量のストリーミング通信によって、限界状態のネットワーク経路がより早く障害を起こすことはありますが、Jellyfin をアンインストールしても、故障したケーブル、PHY、ドライバー、または PCIe 電源状態の相互作用は修復されません。

汎用 x86 サポートも正確なデバイス ID に依存します

ZimaOS は汎用 x86-64 ハードウェアをサポートしますが、どのマザーボードのリビジョン、NIC PHY、BIOS、増設カードにも対応できる互換性リストはありません。サポート報告には正確な PCI ベンダー/デバイス ID と現在の ZimaOS バージョンを含め、IceWhale が既知のサポート対象チップセットと、ボード固有のドライバー問題を区別できるようにしてください。

NETDEV WATCHDOG FAQ

Intel I210 が問題を解決したことを、情報源は確認しましたか?

いいえ。ユーザーはカードを注文しましたが、結果は投稿していません。

このエラーは、すべての r8169/Realtek NIC が ZimaOS 上で不安定であることを証明しますか?

いいえ。現在の IceWhale の互換性ドキュメントには、Realtek NIC の複数のファミリーが含まれています。

NIC を交換する前に何をテストすべきですか?

現在の ZimaOS、別のケーブル/ポート、NIC/ドライバーの正確な識別情報、および障害発生時のカーネル/リンクログ。