ZimaOS Realtek 2,5 GbE saknar nätverk under installationen: felsökning av drivrutiner

Detta installationsfall från november 2025 är värdefullt eftersom användaren genomförde ovanligt omfattande jämförande tester innan hen bad om hjälp. Den inbyggda Realtek 2,5 GbE-styrenheten på ett ASUS TUF Gaming B850M-PLUS WIFI7 fungerade normalt i Proxmox, Unraid och Kubuntu på samma maskin, med samma kabel, switchportar och NVMe-enhet. Endast ZimaOS lyckades inte aktivera gränssnittet under installationens andra steg.

Dessa bevis flyttar felsökningsfokus från routern eller kabeln till den exakta NIC-revisionen, kärnans drivrutinsbindning eller installationsmiljön. Källtråden nådde dock inte fram till någon teknisk grundorsak från IceWhale, så drivrutinsförklaringen måste fortfarande betraktas som en communitydiagnos.

Hårdvaran och felet var mycket specifika

Den rapporterade maskinen hade en AMD Ryzen 7 8700G, 64 GB DDR5, en NVMe-systemdisk på 512 GB och moderkortets inbyggda Realtek 2,5 Gb-Ethernet. Det första USB-bootade steget i ZimaOS-installationen slutfördes normalt och kopierade systemet till NVMe-enheten.

Felet inträffade först efter att installationsprogrammet bad användaren ta bort USB-minnet och starta från den installerade NVMe-enheten. Då behövde miljön i det andra steget nätverk för att slutföra provisioneringen, men Ethernet-gränssnittet fick varken länk eller en DHCP-leasing.

Vad användaren observerade under det andra steget

• Routern visade aldrig någon DHCP-leasing för ZimaOS-installationen.
• Det gick inte att pinga maskinen och inget ZimaOS-webbgränssnitt visades.
• En subnätsgenomsökning hittade ingen ny serveradress.
• ip a visade antingen endast loopback eller ett Ethernet-liknande gränssnitt utan länk och utan en IPv4-adress.
• Upprepade nya installations-USB-minnen gav samma resultat.

Dessa symtom skiljer sig från ett fungerande gränssnitt som bara har fel statisk IP-adress. Själva länken blev inte användbar i den installerade ZimaOS-miljön.

Varför de andra operativsystemen är viktiga

Samma inbyggda nätverksadapter fungerade omedelbart i Proxmox, Unraid och Kubuntu. Routern tilldelade DHCP-adresser, länkdioderna fungerade normalt och maskinen var nåbar utan ytterligare installation av drivrutiner.

Det bevisar inte att ZimaOS har ett generellt Realtek-fel. Det bevisar däremot att det fysiska nätverkskortet, kablaget och switchvägen kunde fungera, vilket gör upprepade kabelbyten mindre meningsfulla efter att dessa kontroller redan har godkänts.

Teorin om r8169 kontra r8125 kom från communityn

En communitymedlem misstänkte att just denna Realtek 2.5GbE-implementering behövde r8125 medan ZimaOS band den till r8169, eller på annat sätt misslyckades med att binda den förväntade drivrutinen under uppstartens andra steg.

Det är rimligt för vissa Realtek-revisioner, men ingen IceWhale-anställd bekräftade i den offentliga tråden enhets-ID:t, den inlästa modulen eller en regression i kärnan. Undvik att omformulera teorin till att ”ZimaOS använder fel drivrutin” utan de faktiska diagnostikresultaten.

De tre skrivskyddade kontroller som efterfrågades av communityn

Den som svarade bad om:

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

De här kommandona är användbara eftersom de inte ändrar installationen. Tillsammans visar de PCI-enhetens ID, vilka nätverksgränssnitt Linux skapade och om relevanta Realtek-drivrutiner rapporterade fel vid identifiering eller länk.

För ett aktuellt system bör du också jämföra gränssnittet med det förväntade Ethernet-tillståndet i den aktuella nätverkspanelen i ZimaOS. Om kärnan aldrig skapar ett användbart gränssnitt ligger problemet tidigare än konfigurationen i webbgränssnittet.

En kompatibilitetslista på familjenivå är ingen garanti för varje revision

Den som publicerade inlägget var förståeligt nog frustrerad eftersom Realtek 2.5GbE-familjen fanns med i IceWhales kompatibilitetsinformation, vilket påverkade köpet av moderkortet. Nätverkskontroller som säljs under liknande marknadsföringsnamn kan ändå skilja sig åt vad gäller PCI-ID:n, kiselrevisioner, fast programvara, PHY-komponenter eller kortets ledningsdragning.

En kompatibilitetsrapport av hög kvalitet bör därför innehålla det exakta lspci -nn identifierare, inte bara ”Realtek 2.5GbE”.

Det enda bekräftade resultatet var en lösning med Intel X540-T1

Sex dagar senare rapporterade den ursprungliga användaren att hen hade köpt ett Intel X540-T1-nätverkskort och sade att det löste problemet. Det är det enda resultat som bekräftats av personen som upplevde felet.

Kringgåendet visar att ZimaOS kunde fortsätta installationen när ett annat kompatibelt nätverkskort tillhandahöll nätverk. Det identifierar inte den exakta orsaken till att den inbyggda Realtek-enheten inte fungerade.

Vad den här tråden inte fastställer

• Den bevisar inte att alla nätverkskort i RTL8125-klassen misslyckas i ZimaOS.
• Den bevisar inte att DHCP var grundorsaken.
• Den bekräftar inte någon specifik saknad kärnmodul.
• Den visar inte att användarens livstidslicens påverkade hårdvarustödet.
• Den innehåller ingen slutgiltig officiell drivrutinsfix från IceWhale.

En bättre felsökningsväg i dag

1. Anteckna nätverkskortets exakta PCI-ID.
2. Bekräfta länklysdioderna och routerns portbeteende.
3. Kontrollera om Linux skapar ett Ethernet-gränssnitt.
4. Granska drivrutinsmeddelanden för den exakta styrenheten.
5. Jämför vid behov beteendet med en annan ny Linux-avbild.
6. Om ett andra, beprövat kompatibelt nätverkskort låter ZimaOS slutföra installationen, spara diagnostiken för den felande styrenheten till en kompatibilitetsrapport i stället för att installera om upprepade gånger.

Installations-FAQ för Realtek 2.5GbE

Var det inbyggda nätverkskortet fysiskt defekt?

Korstesterna talar emot det. Det fungerade omedelbart i flera andra operativsystem.

Var r8169 definitivt fel drivrutin?

Nej. Det var en teori från communityn som den offentliga tråden aldrig bekräftade med de efterfrågade utdata.

Vilken kringgående lösning bekräftades?

Den ursprungliga användaren installerade ett Intel X540-T1-nätverkskort och kunde komma runt installationsproblemet.

Bör jag byta ut mitt nätverkskort innan jag samlar in loggar?

Om möjligt, samla först in PCI-ID, gränssnittets status och relevanta drivrutinsmeddelanden. Dessa uppgifter är mycket mer användbara för att avgöra om en aktuell ZimaOS-version fortfarande har samma kompatibilitetslucka.