Der ursprüngliche Leitfaden zur Fehlerbehebung ist wertvoll, weil er unterhalb der CasaOS-Benutzeroberfläche ansetzt. Wenn sich ein Laufwerk, eine NIC, eine PCIe-Karte oder ein USB-Gerät ungewöhnlich verhält, lautet die erste Frage, ob das zugrunde liegende Linux-System die Hardware überhaupt erkennen kann.
Die wichtige Grenze im Jahr 2026 ist die Architektur des Betriebssystems. Der Leitfaden von 2023 geht davon aus, dass CasaOS auf einer normalen Debian-/Ubuntu-ähnlichen Linux-Installation ausgeführt wird. Aktuelle ZimaOS ist ein separates, auf Buildroot basierendes Appliance-Betriebssystem mit einem weitgehend schreibgeschützten System. Schreibgeschützte Diagnosebefehle bleiben nützlich, aber Anweisungen zur Paketinstallation und Änderung des Hostsystems aus gewöhnlichen Debian-Anleitungen sollten nicht auf ZimaOS übertragen werden.
Mit dmidecode BIOS- und Board-Informationen auslesen
dmidecode liest SMBIOS-/DMI-Daten wie:
- BIOS-Hersteller und -Version;
- Veröffentlichungsdatum;
- System-/Board-Kennungen;
- Speicherinformationen;
- Firmware-Funktionen wie UEFI.
Dies ist nützlich, wenn Sie ein hardwarespezifisches Problem mit einem BIOS-Update vergleichen oder genau feststellen möchten, welche Board-Revision verwendet wird.
Mit lspci überprüfen, ob PCIe-Hardware erkannt wurde
lspci listet Geräte auf, die das PCI-Subsystem erkennt: GPUs, SATA-Controller, NVMe-Adapter, NICs, Capture-Karten und andere Erweiterungshardware.
Wenn eine neue PCIe-NIC nie in lspciliegt das Problem unterhalb von Docker/CasaOS. Überprüfen Sie Steckverbindungen, Stromversorgung, Firmware-Einstellungen, Lane-Sharing und Hardwarekompatibilität, bevor Sie Anwendungssoftware installieren.
Mit lsusb die Identität von USB-Geräten ermitteln
lsusb meldet USB-Hersteller-/Produkt-IDs. Diese IDs sind besonders nützlich bei der Diagnose von WLAN-Adaptern, Coral-TPU-Geräten, USB-Speicherbrücken, Zigbee-Koordinatoren und anderen Peripheriegeräten, die unter einem einzigen Produktnamen in mehreren Hardwareversionen erhältlich sein können.
Mit dmesg Treiber- und Hardwaremeldungen beim Booten anzeigen
dmesg kann Folgendes anzeigen:
- Bindung von Kernel-Treibern;
- Fehler beim Laden der Firmware;
- USB-Trennungs-/Wiederverbindungsereignisse;
- Speicher-I/O-Fehler;
- Änderungen der NIC-Verbindung;
- PCIe-/AER-Fehler.
Filtern oder erfassen Sie nur relevante Abschnitte, anstatt Tausende nicht zusammenhängender Bootzeilen zu posten.
Mit lsblk zwischen „Datenträger nicht erkannt“ und „Datenträger nicht eingehängt“ unterscheiden
lsblk zeigt Datenträger, Partitionen, Dateisystembeziehungen und Einhängepunkte an. Ein Laufwerk, das in lsblk Das Fehlen in der CasaOS-Dateiverwaltung ist jedoch ein anderes Problem als ein Laufwerk, das unter Linux vollständig fehlt.
Schreibgeschützte Erkennung vor Reparaturbefehlen bevorzugen
Der ursprüngliche Teil 1 ist besonders stark, wenn er das Beobachten vermittelt. Befehle wie dmidecode, lspci, lsusb, dmesg, und lsblk kann die Problembene bestimmen, ohne Speicher oder Pakete zu ändern.
Führe dies aus, bevor du Datenträger neu formatierst, Treiber neu installierst, Besitzrechte rekursiv änderst oder Docker neu erstellst.
CasaOS und ZimaOS erfordern unterschiedliche Regeln für Änderungen am Host
CasaOS läuft normalerweise auf einem allgemeinen Linux-Host, auf dem apt ist möglicherweise verfügbar. ZimaOS basiert auf Buildroot, und laut der aktuellen CLI-Dokumentation von IceWhale bleiben die meisten Systemordner auch als Root schreibgeschützt.
Verwende die aktuellen CLI-Grenzen von ZimaOS, wenn dieselbe Hardware unter ZimaOS läuft.
Von der Hardware aufwärts diagnostizieren
Eine sinnvolle Reihenfolge ist:
- BIOS/Firmware erkennt die Hardware;
- Die Linux-Busaufzählung erkennt es;
- ein Kernel-Treiber wird zugeordnet;
- Das Betriebssystem erstellt eine nutzbare Schnittstelle bzw. ein Blockgerät;
- CasaOS/ZimaOS zeigt es in der Benutzeroberfläche an;
- Docker/Anwendungen erhalten das Gerät bzw. den Pfad.
Wenn du direkt zu Ebene sechs springst, wirken viele Hardwareprobleme wie Fehler in Apps.
Mit blkid Dateisystemtyp und UUID ermitteln
Der Quelltext von Teil 1 verwendet außerdem blkid danach lsblk. Dies beantwortet eine andere Frage: Welche Signatur eines Dateisystems oder LVM-Mitglieds enthält die Partition tatsächlich, und welche UUID/PARTUUID identifiziert sie?
Das ist hilfreich, wenn ein Datenträger unter Linux angezeigt wird, aber ein Einhänge- oder Speichermanager das erwartete Dateisystem nicht erkennt. Zeichne die Ausgabe auf, bevor du etwas neu formatierst.
Hardwaredaten sichern, bevor du Treiber oder Speicher änderst
Für einen reproduzierbaren Supportbericht solltest du die relevanten Befehlsausgaben zusammen mit Folgendem erfassen:
- Board-Modell und BIOS-Version;
- Version des Betriebssystems;
- Gerätemodell sowie PCI-/USB-ID;
- was unmittelbar vor dem Problem geändert wurde;
- ob die Hardware im BIOS, unter Linux und in der CasaOS-/ZimaOS-Benutzeroberfläche angezeigt wird.
Damit lässt sich unterscheiden, ob ein Treiber fehlt, ein Kabel defekt ist, ein nicht unterstütztes Dateisystem verwendet wird oder ein Problem bei der Container-Zuordnung vorliegt.
FAQ zur Fehlerbehebung bei Linux-Hardware
Was sollte ich zuerst für eine unbekannte PCIe-Karte ausführen?
lspci ist die schnellste schreibgeschützte Prüfung, ob das PCI-Subsystem das Gerät erkennt.
Was ist für USB-Anbieter- und Produkt-IDs am nützlichsten?
lsusb.
Kann ich die Debian-Paketannahmen des Leitfadens auf ZimaOS anwenden?
Nein. Behalte die Diagnosekonzepte bei, aber befolge die ZimaOS-spezifischen Regeln für Erweiterungen und Treiber.
