Vor dem Firmware-Download: Modell, Revision, Target/Profil und Wiederherstellung
Ergebnis
Abschnitt betitelt „Ergebnis“- Sie kennen das genaue Modell und die Hardware-Revision, nicht ein Modell, das „genauso aussieht“.
- Sie kennen Target/Subtarget/Profil von OpenWrt und wissen, welches Image Sie herunterladen müssen.
- Sie wählen
sysupgrade,factoryoder ein kombiniertes x86-Image korrekt aus. - Sie verifizieren Dateiquelle und Prüfsumme.
- Sie kennen vor dem Flashen den Wiederherstellungsweg und wissen, welchen Weg Sie bei einem Fehlschlag einschlagen.
Dies ist eine Checkliste für die Zeit vor dem Download, keine Flash-Anleitung. Bare-Metal-Flashen, Bootloader-Wiederherstellung und Migrationen über Hauptversionen hinweg sind R2: Nutzen Sie unabhängige Prüfung und die Gerätedokumentation. Betrachten Sie diese Seite nicht als allgemeines Flash-Tutorial.
Beginnen Sie mit dem Typenschild
Abschnitt betitelt „Beginnen Sie mit dem Typenschild“Prüfen Sie das Typenschild an der Unterseite, den Karton und das Handbuch; notieren Sie:
- Hersteller + vollständiges Modell (nicht nur die Serie);
- Hardware-Revision (v1, v2, V2.1 usw.);
- Region bzw. Anbieter-Variante;
- FCC-ID und Präfix der Seriennummer, falls vorhanden (veröffentlichen Sie sie nicht);
- Wiederherstellungsmethode (Reset-Taste, TFTP, Seriell, Herstellerwerkzeug).
Ein Modell kann mehrere Revisionen mit unterschiedlichem Flash, anderen WLAN-Chips oder anderen Partitionslayouts haben. Derselbe Modellname bedeutet nicht, dass es ein universelles Image gibt.
ErwartetModell, Revision, Region und Details des Typenschilds sind notiert.
ubus call system boardcat /etc/openwrt_releasecat /tmp/sysinfo/model 2>/dev/nullcat /tmp/sysinfo/board_name 2>/dev/nullWichtige Felder: release.distribution, release.version, release.target, model, board_name. model ist nicht die Hardware-Revision; wählen Sie ein Image nicht allein anhand dieser Zeile aus.
Erwartetdistribution/target/model/board_name stimmen mit der Geräteseite überein.
cat /sys/class/dmi/id/sys_vendorcat /sys/class/dmi/id/product_namecat /sys/class/dmi/id/board_namecat /sys/class/dmi/id/board_versioncat /sys/class/dmi/id/bios_versionBestätigen Sie außerdem BIOS/Legacy gegenüber UEFI, die Festplattenschnittstelle und ob das Image combined/ext4 ist. Davon hängt ab, ob es bootet; „x86/64“ allein genügt nicht.
ErwartetSie kennen das Board- bzw. Gerätemodell und vermischen keine PC- und VM-Images.
Den Firmware Selector prüfen
Abschnitt betitelt „Den Firmware Selector prüfen“Öffnen Sie den OpenWrt Firmware Selector:
- Wählen Sie das richtige Release (z. B. 25.12.6).
- Suchen Sie nach dem vollständigen Modell und öffnen Sie dessen Geräteseite.
- Prüfen Sie Target/Subtarget, Profil und Hardware-Revision.
- Lesen Sie den Abschnitt „Installation“ der Geräteseite für die Image-Typen bei Erstinstallation und Upgrade.
- Laden Sie herunter und verifizieren Sie SHA-256; benennen Sie eine Datei nicht einfach um.
Widersprechen sich Selector und Geräteseite, brechen Sie ab und prüfen Sie Modell/Revision; wählen Sie nicht die nächstliegende Übereinstimmung.
ErwartetSie finden die genaue Geräteseite und das passende Image.
Image-Typen
Abschnitt betitelt „Image-Typen“| Image/Szenario | Verwendung | Hauptrisiko |
|---|---|---|
sysupgrade |
Vorhandenes OpenWrt, Upgrade mit/ohne Konfiguration | Inkompatibilität von Paketen/Kernel-Modulen über Versionen hinweg |
factory / Herstellerübergang |
Erstinstallation von Hersteller-Firmware | abweichende Partitionierung bzw. Flash-Methode kann das Gerät unbrauchbar machen |
| x86 combined/ext4 | Image für die ganze x86-Festplatte/VM | BIOS/UEFI, Festplattenlayout, Schreibmethode |
| Hersteller-Firmware | Web-Oberfläche des Herstellers/Wiederherstellungswerkzeug | nicht mit OpenWrt-Images vermischen |
| „universelle/ohne Zerlegen“-Pakete | Unbekannte Quelle | meiden; Target/Profil/Prüfsumme lassen sich nicht verifizieren |
Ein Dateiname mit sysupgrade ist kein Beweis; Target, Profil, Revision und Prüfsumme müssen alle passen.
Herunterladen und verifizieren
Abschnitt betitelt „Herunterladen und verifizieren“Bevorzugen Sie:
- OpenWrt
downloads.openwrt.orgoder den Firmware Selector; - die offizielle Download-Seite des Geräteherstellers;
- die offizielle Release-Seite eines Projekts (bei Firmware von Drittanbietern sind zusätzliche Prüfungen von Maintainer/Signatur nötig).
Verwenden Sie keine Cloud-Speicher-Spiegel, Forenanhänge oder „vorab modifizierten“ Pakete aus Chats. Neu gepackte Images können Skripte, alte Kernel oder nicht passende Treiber enthalten.
ErwartetDie Dateiquelle ist nachvollziehbar und besitzt eine Prüfsumme.
Linux:
sha256sum openwrt-*.img.gzmacOS:
shasum -a 256 openwrt-*.img.gzWindows:
certutil -hashfile openwrt-*.img.gz SHA256Vergleichen Sie mit den offiziellen sha256sums bzw. der Release-Seite. Weicht sie ab, laden Sie erneut herunter; flashen Sie nicht nach dem Motto „mal sehen, was passiert“.
ErwartetDie Prüfsumme stimmt mit der offiziellen Release-Seite überein.
Wiederherstellung vor dem Flashen
Abschnitt betitelt „Wiederherstellung vor dem Flashen“Bestätigen Sie mindestens:
- wie Sie Failsafe aufrufen (Tastenzeitpunkt/Seriell/IP);
- ob TFTP/Seriell/Herstellerwiederherstellung verfügbar ist;
- die LAN-Verwaltungsadresse, das Gateway und das root-Passwort;
- die Konfigurationssicherung:
sysupgrade -bunter vorhandenem OpenWrt oder der Export des Herstellers; - installierte Pakete/Kernel-Module, die nach dem Upgrade neu aufgebaut werden müssen;
- eine stabile Stromversorgung; trennen Sie das Gerät während des Flashens nicht.
Kein Wiederherstellungsweg, keine Prüfsumme, keine Sicherung: Beginnen Sie nicht.
ErwartetSie wissen, wie Sie bei einem Fehlschlag Failsafe/Recovery aufrufen.
Häufige Fehler
Abschnitt betitelt „Häufige Fehler“- Nur das Modell prüfen, nicht die Revision;
sysupgradealsfactoryverwenden oder umgekehrt;- das Image eines anderen Targets umbenennen und flashen;
- trotz abweichender Prüfsumme fortfahren;
- unbekannte „universelle/erweiterte“ Pakete verwenden;
- während des Flashens den Strom verlieren oder das Kabel ziehen;
- nach dem Upgrade von Erfolg ausgehen, ohne DNS/Firewall/Pakete zu prüfen.
Fehlerfälle
Abschnitt betitelt „Fehlerfälle“Falsches Modell heruntergeladen
Abschnitt betitelt „Falsches Modell heruntergeladen“Löschen Sie es und laden Sie von der Geräteseite herunter; probieren Sie es nicht „einfach aus“. Haben Sie bereits geflasht, nutzen Sie die Wiederherstellungsdokumentation des Geräts (Failsafe/TFTP/Seriell); flashen Sie nicht immer weiter verschiedene Images.
Prüfsumme stimmt nicht überein
Abschnitt betitelt „Prüfsumme stimmt nicht überein“Laden Sie erneut herunter; prüfen Sie, ob Proxy oder Spiegel die Datei abgeschnitten haben; wechseln Sie zur offiziellen Quelle. Deaktivieren Sie die Verifizierung nicht.
Ihre Revision ist nicht aufgeführt
Abschnitt betitelt „Ihre Revision ist nicht aufgeführt“Prüfen Sie die Herstellerseite bzw. das Typenschild oder das OpenWrt-Forum bzw. die Geräteseite. Ohne ausdrückliche Unterstützung gehen Sie nicht von Kompatibilität aus.
Hersteller-Firmware ist gesperrt
Abschnitt betitelt „Hersteller-Firmware ist gesperrt“Verwenden Sie das Verfahren des Herstellers; umgehen Sie Signaturen oder Sperren nicht, nur um OpenWrt zu installieren. Klären Sie vorher die Abwägung zwischen Garantie und Herstellerfunktionen.
E1-Status und Quellen
Abschnitt betitelt „E1-Status und Quellen“- Dies ist E1: Felder, Image-Typen und Wiederherstellung beruhen auf öffentlicher Dokumentation; auf einem Gerät wurde weder heruntergeladen noch geflasht.
- Modell/Revision stammen vom Typenschild und der Herstellerseite; übertragen Sie Erfahrungen mit x86-VMs nicht auf Router.
- Recipe:
tests/recipes/firmware-download-check.md; Flash-Schritte liegen außerhalb des Umfangs.
Quellen
Unabhängige OpenWrt-Notizen. Jede Seite nennt Firmware, Gerät, Paketmanager und den Rückweg.
Symbole: Solar by 480 Design, CC BY 4.0