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

インストール中にZimaOSのRealtek 2.5GbEでネットワーク接続がない場合:ドライバーのトラブルシューティング

A November 2025 installation case where an ASUS B850M board's onboard Realtek 2.5GbE worked in Proxmox, Unraid, and Kubuntu but not during ZimaOS's second install stage. A community reply suspected r8169 versus r8125 binding, while the user ultimately bypassed the issue with an Intel X540-T1 NIC.

2025年11月のこのインストール事例が貴重なのは、ユーザーが助けを求める前に、通常よりも入念なクロステストを行っていたためです。同じマシン、ケーブル、スイッチポート、NVMeを使った環境で、ASUS TUF Gaming B850M-PLUS WIFI7のオンボードRealtek 2.5GbEコントローラーは、Proxmox、Unraid、Kubuntuでは正常に動作しました。第2ステージのインストール中にインターフェースを起動できなかったのは、ZimaOSだけでした。

この証拠から、トラブルシューティングの対象はルーターやケーブルではなく、NICの正確なリビジョン、カーネルドライバーのバインド、またはインストーラー環境へと移ります。ただし、元のスレッドではIceWhaleによるエンジニアリング上の根本原因までは特定されていないため、ドライバーが原因だという説明は、あくまでコミュニティによる診断にとどまります。

ハードウェアと障害は非常に限定的でした

報告されたマシンは、AMD Ryzen 7 8700G、64 GB DDR5、512 GBのNVMeシステムディスク、およびマザーボード上のRealtek 2.5Gbイーサネットを搭載していました。USBから起動したZimaOSインストールの第1ステージは正常に完了し、システムをNVMeにコピーしました。

障害が発生したのは、インストーラーがUSBメモリを取り外して、インストール済みのNVMeから起動するよう求めた後だけでした。この時点では、プロビジョニングを完了するために第2ステージ環境でネットワークが必要でしたが、イーサネットインターフェースはキャリアもDHCPリースも取得しませんでした。

第2ステージでユーザーが確認した内容

  • ルーターには、ZimaOSのインストールに対するDHCPリースが一度も表示されませんでした。
  • マシンにはpingを送信できず、ZimaOSのWebインターフェースも表示されませんでした。
  • サブネットスキャンでも、新しいサーバーアドレスは見つかりませんでした。
  • ip a ループバックインターフェースしか表示されないか、キャリアもIPv4アドレスもないイーサネット形式のインターフェースしか表示されませんでした。
  • 新しく作成したインストーラーUSBを何度試しても、同じ結果になりました。

これらの症状は、単に静的IPが間違っているだけの、正常に動作するインターフェースとは異なります。インストール済みのZimaOS環境では、リンク自体が使用可能な状態になっていませんでした。

他のオペレーティングシステムが重要な理由

同じオンボードNICは、Proxmox、Unraid、Kubuntuではすぐに動作しました。ルーターはDHCPアドレスを割り当て、リンクLEDも正常に動作し、追加のドライバーをインストールしなくてもマシンに接続できました。

これは、ZimaOSに汎用的なRealtekのバグがあることを証明するものではありません。ただし、物理NIC、ケーブル、スイッチ経路が動作可能だったことは証明されるため、これらの確認をすでに通過した後でケーブルを何度も交換することの有用性は低くなります。

r8169とr8125の理論はコミュニティから出たものです

コミュニティの回答者は、この特定のRealtek 2.5GbE実装には次のものが必要ではないかと推測しました r8125 ZimaOSがそれをバインドしていた一方で r8169または、セカンドステージのブート中に想定されたドライバーへのバインドに失敗している。

一部のRealtekリビジョンではその可能性がありますが、公開スレッドではIceWhaleの従業員がデバイスID、読み込まれたモジュール、カーネルのリグレッションを確認していません。実際の診断出力なしに、「ZimaOSは間違ったドライバーを使用している」と理論を言い換えるのは避けてください。

コミュニティが求めた3つの読み取り専用チェック

回答者が求めたもの:

lspci -nn | grep -i ethernet
ip a
dmesg | grep -i -e r8169 -e r8125 -e realtek

これらのコマンドが役立つのは、インストールを変更しないためです。まとめて実行すると、PCIデバイスID、Linuxが作成したネットワークインターフェース、関連するRealtekドライバーがプローブエラーやリンクエラーを報告しているかどうかが分かります。

現在のシステムでは、インターフェースが現在のZimaOSネットワークパネルで想定されるEthernetの状態とも一致するか確認してください。カーネルが使用可能なインターフェースを作成していない場合、問題はWeb UIの設定より前の段階にあります。

ファミリーレベルの互換性掲載は、すべてのリビジョンに対する保証ではありません

投稿者が、IceWhaleの互換性情報にRealtek 2.5GbEファミリーが掲載されており、それがマザーボードの購入判断に影響したため、当然ながら不満を感じたのは理解できます。同様のマーケティング名で販売されているネットワークコントローラーでも、PCI ID、シリコンのリビジョン、ファームウェア、PHYコンポーネント、基板上の配線が異なる場合があります。

したがって、高品質な互換性レポートには正確な lspci -nn 識別子。「Realtek 2.5GbE」だけではありません。

確認された唯一の結果は Intel X540-T1 による回避策だった

6日後、元のユーザーは Intel X540-T1 NIC を購入し、それによって問題を回避できたと報告しました。これが、問題を経験した本人によって確認された唯一の結果です。

この回避策によって、別の互換 NIC がネットワーク接続を提供すれば ZimaOS はインストールを続行できることが確認されました。ただし、オンボードの Realtek デバイスが失敗した正確な理由までは特定されていません。

このスレッドからは確定できないこと

  • RTL8125 クラスのすべての NIC が ZimaOS で失敗することを証明していません。
  • DHCP が根本原因だったことを証明していません。
  • 特定のカーネルモジュールが不足していたことを確認していません。
  • ユーザーの永久ライセンスがハードウェアサポートに影響したことは示していません。
  • 最終的な公式の IceWhale 製ドライバ修正は含まれていません。

現在の、より良いトラブルシューティング手順

  1. NIC の正確な PCI ID を記録してください。
  2. リンク LED とルーターのポートの動作を確認してください。
  3. Linux が Ethernet インターフェースを作成するかどうかを確認してください。
  4. 対象のコントローラーについて、ドライバメッセージを確認してください。
  5. 必要に応じて、別の最近の Linux イメージでも動作を比較してください。
  6. 既知の互換 NIC を2枚目として使用すると ZimaOS のインストールを完了できる場合は、何度も再インストールするのではなく、互換性レポート用に問題のコントローラーの診断情報を保存してください。

Realtek 2.5GbE インストール FAQ

オンボード NIC は物理的に故障していたのですか?

クロステストの結果は、その見方に反しています。他の複数のオペレーティングシステムでは、すぐに動作しました。

r8169 は確実に間違ったドライバだったのですか?

いいえ。それはコミュニティ内の仮説であり、公開スレッドでは要求された出力によって確認されていません。

確認された回避策は何でしたか?

元のユーザーは Intel X540-T1 ネットワークカードを取り付けることで、インストールの問題を回避できました。

ログを収集する前に、NIC を交換すべきですか?

可能であれば、まず PCI ID、インターフェースの状態、関連するドライバメッセージを収集してください。これらの詳細のほうが、現在の ZimaOS ビルドにも同じ互換性の問題が残っているかどうかを判断するうえではるかに役立ちます。