Elige una imagen x86: combined, ext4, squashfs, EFI/BIOS
Elección en una línea
Sección titulada «Elección en una línea»- PVE con SeaBIOS por defecto: prefiere
generic-ext4-combined.img.gz(probado aquí); - UEFI/OVMF: elige una imagen combined con
-efi; - restablecimiento de fábrica / root de solo lectura + overlay: elige squashfs combined;
- bootloader y particiones existentes, reemplazar solo el rootfs: usa una imagen rootfs;
- contenedor/chroot:
rootfs.tar.gz, no una imagen de disco.
Lee el nombre del archivo
Sección titulada «Lee el nombre del archivo»Archivos principales de x86/64 en 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.gzTres palabras importan:
| Palabra | Significado | Si te equivocas |
|---|---|---|
combined |
imagen de disco completo con tabla de particiones y arranque | usarla como rootfs puede sobrescribir particiones |
rootfs |
solo el sistema de archivos | sin bootloader; no puede arrancar directamente |
ext4 / squashfs |
root escribible / root de solo lectura + overlay | afecta a la recuperación y al comportamiento de escritura |
-efi |
arranque UEFI | puede que el BIOS legacy no la arranque |
tar.gz |
archivo comprimido del rootfs | no es una imagen de disco arrancable |
ext4 frente a squashfs
Sección titulada «ext4 frente a squashfs»- ext4 combined: root escribible; habitual en VM y soft routers; se comporta como una instalación normal de Linux.
- squashfs combined: root de solo lectura, configuración en el overlay; mejor para el restablecimiento de fábrica y para evitar errores; el espacio y el mantenimiento son distintos.
- Ambas pueden arrancar en PVE; este laboratorio solo probó ext4. No te saltes las copias de seguridad porque «squashfs es más seguro».
BIOS frente a UEFI
Sección titulada «BIOS frente a UEFI»- PVE con
SeaBIOSpor defecto: usa una imagen combined sin-efi; - PVE con
OVMF (UEFI): usa combined-efiy prepara un disco EFI; - Físico: comprueba
UEFI/Legacyen el firmware y haz que coincidan; - Elección equivocada: sin entrada de arranque, GRUB no se inicia, cae a PXE/BIOS.
Este laboratorio: VM 200 de PVE, SeaBIOS + generic-ext4-combined; arrancó correctamente.
Descarga y verificación
Sección titulada «Descarga y verificación»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 -Este laboratorio: .img.gz de 13,0 MB, .img de 120,5 MB tras descomprimir; el SHA-256 coincidió.
EsperadoLa fuente oficial/TUNA y el checksum son correctos.
gzip -dk openwrt-25.12.6-x86-64-generic-ext4-combined.img.gzls -lh openwrt-25.12.6-x86-64-generic-ext4-combined.imgsysupgrade y qm importdisk de PVE usan .img; no escribas el .gz directamente en el disco.
EsperadoUn .img listo para importar o escribir.
Importar en PVE
Sección titulada «Importar en 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 usa UEFI/OVMF, utiliza la imagen -efi y un disco EFI; no fuerces una imagen BIOS en UEFI.
EsperadoLa VM arranca desde el disco importado, no desde ISO/PXE.
qm terminal 200# or inside the VMubus call system boardcat /etc/openwrt_releaseEste laboratorio arrancó 25.12.6 x86/64; LAN por defecto 192.168.1.1.
EsperadoLa consola muestra OpenWrt y la versión y el target correctos.
Escritura en disco físico
Sección titulada «Escritura en disco físico»# verify the target first; do not copy the wrong device namelsblksudo dd if=openwrt-...-combined.img of=/dev/sdX bs=4M status=progress conv=fsyncsyncddsobrescribe todo el destino; desconecta los discos no relacionados y verifica el dispositivo;- Para UEFI, elige
-efi; - Arranca desde ese disco; no dejes que el ISO mantenga la prioridad de arranque;
- Los nombres de las NIC físicas pueden no coincidir con
eth0/eth1de PVE; identifícalas por MAC/PCI.
Fallos comunes
Sección titulada «Fallos comunes»La importación en PVE no arranca
Sección titulada «La importación en PVE no arranca»- el orden de arranque no es
scsi0; - elegiste rootfs en lugar de combined;
- la imagen BIOS/UEFI no coincide;
- el bus o controlador de disco no coincide;
- la consola serie no está configurada, por lo que no hay registro de arranque.
Falla el arranque UEFI en hardware físico
Sección titulada «Falla el arranque UEFI en hardware físico»- imagen sin
-efi; - el BIOS sigue en Legacy/CSM;
- escritura incompleta en el USB;
- restricciones de Secure Boot o de firma.
El sistema original desapareció tras escribir
Sección titulada «El sistema original desapareció tras escribir»dd escribió en el disco equivocado. Haz una copia de seguridad, verifica el tamaño y el modelo con lsblk y luego escribe; no pruebes en una máquina de producción.
La imagen rootfs no arranca directamente
Sección titulada «La imagen rootfs no arranca directamente»rootfs no tiene bootloader ni tabla de particiones; usa un bootloader existente o la vía adecuada de contenedor o virtualización.
Prueba de laboratorio E2 (2026-10-20)
Sección titulada «Prueba de laboratorio E2 (2026-10-20)»- Entorno: PVE 9.2.2; OpenWrt 25.12.6 x86/64;
generic-ext4-combined.img.gz; SeaBIOS. - Descarga:
.img.gzde 13,0 MB;.imgde 120,5 MB; el SHA-256 coincidió con elsha256sumsoficial. - PVE:
qm importdisk→scsi0→boot order=scsi0; la VM arrancó 25.12.6. - No probado:
-efi/OVMF, squashfs, USB físico, Secure Boot, diferencias de la imagen de 24.10. - Receta:
tests/recipes/x86-image-25.12.md.
Fuentes y revisión
Sección titulada «Fuentes y revisión»- Esto es E2 parcial: se probaron BIOS/ext4 combined + importación en PVE; no se probaron UEFI, squashfs ni la escritura física.
- Los nombres y la disponibilidad de las imágenes cambian con cada versión; usa la página de descargas.
- No hay revisor independiente; las conclusiones se limitan a este entorno PVE/VM.
Fuentes
Notas independientes sobre OpenWrt. Cada página indica el firmware, el dispositivo, el gestor de paquetes y la vía de retorno.
Iconos: Solar by 480 Design, CC BY 4.0