Choisir une image x86 : combined, ext4, squashfs, EFI/BIOS
Le choix en une ligne
Section intitulée « Le choix en une ligne »- SeaBIOS, par défaut sous PVE : préférez
generic-ext4-combined.img.gz(testé ici) ; - UEFI/OVMF : choisissez une image combined avec
-efi; - réinitialisation d’usine, racine en lecture seule + overlay : choisissez squashfs combined ;
- bootloader et partitions existants, remplacement du rootfs seul : utilisez une image rootfs ;
- conteneur/chroot :
rootfs.tar.gz, pas une image de disque.
Lire le nom de fichier
Section intitulée « Lire le nom de fichier »Principaux fichiers x86/64 de la version 25.12.6 :
openwrt-25.12.6-x86-64-generic-ext4-combined.img.gzopenwrt-25.12.6-x86-64-generic-ext4-combined-efi.img.gzopenwrt-25.12.6-x86-64-generic-squashfs-combined.img.gzopenwrt-25.12.6-x86-64-generic-squashfs-combined-efi.img.gzopenwrt-25.12.6-x86-64-generic-ext4-rootfs.img.gzopenwrt-25.12.6-x86-64-generic-squashfs-rootfs.img.gzopenwrt-25.12.6-x86-64-generic-kernel.binopenwrt-25.12.6-x86-64-generic-targz-rootfs.tar.gzopenwrt-25.12.6-x86-64-rootfs.tar.gzTrois mots comptent :
| Mot | Signification | En cas d’erreur |
|---|---|---|
combined |
image de disque entier avec table de partitions et démarrage | l’utiliser comme rootfs peut écraser des partitions |
rootfs |
système de fichiers seul | pas de bootloader ; ne peut pas démarrer directement |
ext4 / squashfs |
racine inscriptible / racine en lecture seule + overlay | influe sur la récupération et le comportement en écriture |
-efi |
démarrage UEFI | le BIOS Legacy peut ne pas le démarrer |
tar.gz |
archive rootfs | n’est pas une image de disque amorçable |
ext4 ou squashfs
Section intitulée « ext4 ou squashfs »- ext4 combined : racine inscriptible ; courante pour les VM et routeurs logiciels ; se comporte comme une installation Linux classique.
- squashfs combined : racine en lecture seule, configuration dans l’overlay ; meilleure réinitialisation d’usine et protection contre les erreurs ; espace et maintenance différents.
- Les deux peuvent démarrer sous PVE ; cet essai n’a testé que ext4. Ne sautez pas les sauvegardes sous prétexte que « squashfs est plus sûr ».
BIOS ou UEFI
Section intitulée « BIOS ou UEFI »SeaBIOSpar défaut sous PVE : utilisez une image combined sans-efi;OVMF (UEFI)sous PVE : utilisez une image combined-efiet préparez un disque EFI ;- Machine physique : vérifiez
UEFI/Legacydans le micrologiciel et faites correspondre ; - Mauvais choix : aucune entrée de démarrage, GRUB ne se lance pas, retour au PXE/BIOS.
Cet essai : VM PVE 200, SeaBIOS + generic-ext4-combined ; démarrage réussi.
Télécharger et vérifier
Section intitulée « Télécharger et vérifier »curl -LO https://downloads.openwrt.org/releases/25.12.6/targets/x86/64/openwrt-25.12.6-x86-64-generic-ext4-combined.img.gzcurl -LO https://downloads.openwrt.org/releases/25.12.6/targets/x86/64/sha256sumsgrep 'generic-ext4-combined.img.gz' sha256sums | sha256sum -c -Cet essai : .img.gz de 13,0 Mo, .img de 120,5 Mo après décompression ; le SHA-256 correspondait.
AttenduLa source officielle ou TUNA et la somme de contrôle sont validées.
gzip -dk openwrt-25.12.6-x86-64-generic-ext4-combined.img.gzls -lh openwrt-25.12.6-x86-64-generic-ext4-combined.imgsysupgrade et qm importdisk de PVE utilisent le .img ; n’écrivez pas directement le .gz sur le disque.
AttenduUn .img prêt à être importé ou écrit.
Importer dans PVE
Section intitulée « Importer dans PVE »qm create 200 --name openwrt --memory 512 --cores 2 --cpu host \ --scsihw virtio-scsi-pci --ostype l26 --vga std --serial0 socket \ --net0 virtio,bridge=vmbr0
qm importdisk 200 openwrt-25.12.6-x86-64-generic-ext4-combined.img local-lvmqm set 200 --scsi0 local-lvm:vm-200-disk-0qm set 200 --boot order=scsi0qm start 200Si PVE utilise UEFI/OVMF, prenez l’image -efi et un disque EFI ; ne forcez pas une image BIOS sur de l’UEFI.
AttenduLa VM démarre depuis le disque importé, et non depuis l'ISO ou le PXE.
qm terminal 200# or inside the VMubus call system boardcat /etc/openwrt_releaseCet essai a démarré la version 25.12.6 x86/64 ; LAN par défaut 192.168.1.1.
AttenduLa console affiche OpenWrt avec la bonne version et la bonne target.
Écriture sur un disque physique
Section intitulée « Écriture sur un disque physique »# verify the target first; do not copy the wrong device namelsblksudo dd if=openwrt-...-combined.img of=/dev/sdX bs=4M status=progress conv=fsyncsyncddécrase toute la cible ; déconnectez les disques sans rapport et vérifiez le périphérique ;- Pour l’UEFI, choisissez
-efi; - Démarrez depuis ce disque ; ne laissez pas l’ISO garder la priorité de démarrage ;
- Les noms des cartes réseau physiques peuvent différer de
eth0/eth1sous PVE ; identifiez-les par MAC ou PCI.
Échecs courants
Section intitulée « Échecs courants »L’import PVE ne démarre pas
Section intitulée « L’import PVE ne démarre pas »- l’ordre de démarrage n’est pas
scsi0; - vous avez choisi rootfs au lieu de combined ;
- image BIOS/UEFI inadaptée ;
- bus ou contrôleur de disque inadapté ;
- console série non configurée, donc aucun journal de démarrage.
Le démarrage UEFI physique échoue
Section intitulée « Le démarrage UEFI physique échoue »- image sans
-efi; - le BIOS est toujours en Legacy/CSM ;
- écriture USB incomplète ;
- restrictions de Secure Boot ou de signature.
Le système d’origine a disparu après l’écriture
Section intitulée « Le système d’origine a disparu après l’écriture »dd a écrit sur le mauvais disque. Sauvegardez, vérifiez la taille et le modèle avec lsblk, puis écrivez ; ne testez pas sur une machine de production.
L’image rootfs ne démarre pas directement
Section intitulée « L’image rootfs ne démarre pas directement »Le rootfs n’a ni bootloader ni table de partitions ; utilisez un bootloader existant ou la voie de conteneur ou de virtualisation appropriée.
Essai de laboratoire E2 (2026-10-20)
Section intitulée « Essai de laboratoire E2 (2026-10-20) »- Environnement : PVE 9.2.2 ; OpenWrt 25.12.6 x86/64 ;
generic-ext4-combined.img.gz; SeaBIOS. - Téléchargement :
.img.gzde 13,0 Mo ;.imgde 120,5 Mo ; le SHA-256 correspondait ausha256sumsofficiel. - PVE :
qm importdisk→scsi0→boot order=scsi0; la VM a démarré la version 25.12.6. - Non testé :
-efi/OVMF, squashfs, USB physique, Secure Boot, différences avec l’image 24.10. - Recette :
tests/recipes/x86-image-25.12.md.
Sources et relecture
Section intitulée « Sources et relecture »- Il s’agit d’un E2 partiel : BIOS/ext4 combined et l’import PVE ont été testés ; UEFI, squashfs et l’écriture physique ne l’ont pas été.
- Les noms et la disponibilité des images changent selon la version ; utilisez la page de téléchargement.
- Aucun relecteur indépendant ; les conclusions se limitent à cet environnement PVE/VM.
Sources
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