Quel OpenWrt est-ce : officiel, ImmortalWrt, iStoreOS ou firmware constructeur ?

Résultat attendu

Déterminer si l’appareil exécute OpenWrt officiel, ImmortalWrt, iStoreOS ou un firmware constructeur.
Lire la distribution, la version, la révision, la cible, l’architecture et le modèle matériel.
Savoir si le gestionnaire de paquets est apk ou opkg, et quels dépôts lui correspondent.
Choisir la bonne image sysupgrade ou constructeur au lieu d’en flasher une mauvaise.

Commencez par trois commandes en lecture seule

Shell du routeurLisez les données de la carte système

ubus call system board
cat /etc/openwrt_release

Les quatre champs clés sont release.distribution, release.version, release.target et model.

AttenduVous voyez la distribution, la version, la cible et le modèle.

Shell du routeurLisez le gestionnaire de paquets et l'architecture

command -v apk
command -v opkg
cat /etc/apk/arch 2>/dev/null
opkg print-architecture 2>/dev/null
uname -a

Ne devinez pas le gestionnaire de paquets d’après le numéro de version : l’OpenWrt officiel 25.12 utilise généralement apk, la 24.10 utilise opkg, mais les forks et les images constructeur peuvent différer. Fiez-vous à la commande qui existe.

AttenduVous savez s'il s'agit d'apk ou d'opkg, et connaissez l'architecture du CPU.

Shell du routeurLisez le modèle et la révision matérielle

x86 :

cat /sys/class/dmi/id/sys_vendor
cat /sys/class/dmi/id/product_name
cat /sys/class/dmi/id/board_name
cat /sys/class/dmi/id/board_version
cat /sys/class/dmi/id/bios_version

ARM/routeur :

cat /tmp/sysinfo/model
cat /tmp/sysinfo/board_name

model n’est pas la révision matérielle ; un même modèle peut exister en plusieurs révisions. Avant de flasher, appuyez-vous sur l’étiquette, board_name et la page de téléchargement du constructeur.

AttenduLe modèle et le nom de la carte correspondent à l'étiquette de l'appareil.

Tableau de décision

Champ/indice	OpenWrt officiel	ImmortalWrt	iStoreOS	Firmware constructeur
`release.distribution`	`OpenWrt`	généralement `ImmortalWrt`	généralement `iStoreOS`/constructeur	constructeur
Dépôts	`downloads.openwrt.org`	dépôts ImmortalWrt	dépôts iStoreOS	boutique du constructeur
Gestionnaire de paquets	`apk` (25.12) ou `opkg` (24.10)	vérifiez la commande	généralement `opkg`	peut être absent ou restreint
Interface web	LuCI	LuCI + personnalisations	interface iStoreOS	interface du constructeur
Image de mise à niveau	sysupgrade OpenWrt	image ImmortalWrt	image iStoreOS	firmware constructeur
Support	communauté OpenWrt	communauté ImmortalWrt	communauté iStoreOS	constructeur

Ne mélangez pas les dépôts officiels OpenWrt dans ImmortalWrt ou iStoreOS, et ne flashez pas le sysupgrade d’un autre modèle : l’ABI, le noyau et la disposition des partitions peuvent ne pas correspondre.

Pourquoi la page « À propos » ne suffit pas

Certaines images constructeur changent l’apparence de LuCI mais ne sont pas de l’OpenWrt officiel en dessous.
DISTRIB_DESCRIPTION peut être personnalisé et ne suffit pas à lui seul.
Un même numéro de version n’implique pas la même cible ni le même profil.
Le gestionnaire de paquets et les dépôts sont ce qui compte vraiment pour installer des extensions.

Recoupez ubus call system board, /etc/openwrt_release et le gestionnaire de paquets.

Choisir l’image de mise à niveau

Shell du routeurNotez la cible et board_name

ubus call system board

Concentrez-vous sur :

release.target (par ex. x86/64, mediatek/filogic) ;
board_name ;
model ;
la version et la révision actuelles.

Pour les appareils officiels, utilisez le sélecteur de firmware OpenWrt avec la cible et le modèle exacts. Les appareils ImmortalWrt, iStoreOS ou constructeur utilisent leurs propres pages de téléchargement. Ne flashez jamais un sysupgrade provenant d’un autre modèle ou d’une autre cible.

AttenduVous trouvez une correspondance exacte dans le sélecteur de firmware ou sur la page du constructeur.

Shell du routeurConfirmez le type d'image

La mise à niveau d’un OpenWrt existant utilise généralement sysupgrade.
La première installation depuis un firmware constructeur utilise généralement une image de transition factory/constructeur.
Les x86 peuvent utiliser des images combined/ext4 écrites différemment.
En cas de doute, lisez la page de l’appareil ; ne devinez pas d’après le nom du fichier.

AttenduVous savez s'il s'agit d'un sysupgrade ou d'une image factory/constructeur.

Branches d’échec et récupération

`ubus` est absent ou échoue

Il peut s’agir d’un firmware constructeur ou d’un système qui n’est pas OpenWrt. Consultez la page « À propos/Système » de l’interface web et l’étiquette de l’appareil ; ne flashez pas OpenWrt à l’aveugle.

Interface web uniquement, pas de SSH

Le firmware constructeur peut désactiver SSH. Consultez d’abord la documentation du constructeur et la garantie ; ne flashez pas uniquement pour obtenir root. Si vous avez besoin des fonctions du constructeur, utilisez sa procédure de mise à niveau.

Les paquets ne s’installent pas

Le gestionnaire de paquets ne correspond pas au firmware (apk ou opkg) ;
architecture ou version du dépôt incompatible ;
ABI des modules du noyau incompatible ;
des dépôts d’un autre fork sont mélangés.

Revenez à ubus call system board et au gestionnaire de paquets, confirmez la source, puis diagnostiquez.

Mauvaise image / appareil briqué

Arrêtez de flasher. Utilisez le failsafe de l’appareil, TFTP ou la procédure de récupération du constructeur. Si vous n’avez aucune voie de récupération, n’essayez pas « encore une image ».

Statut E1 et sources

Il s’agit d’un E1 : les champs, le tableau de décision et la méthode de choix d’image reposent sur la documentation publique ; aucun appareil n’a été relevé dans cet environnement.
Les forks et les sorties constructeur peuvent différer ; exécutez tests/recipes/which-openwrt.md sur un appareil réel, enregistrez les champs et les captures d’écran, puis passez en E2.
Cette page ne sert qu’à identifier le firmware ; elle ne fournit ni flashage entre modèles ni contournement des restrictions constructeur.

Sources

Router.Homes

Notes indépendantes sur OpenWrt. Chaque page précise le firmware, l’appareil, le gestionnaire de paquets et le retour arrière.

Icônes : Solar by 480 Design, CC BY 4.0