Copia de seguridad y restauración: verifica por separado configuración, paquetes y administración

Tres «copias de seguridad» distintas

Tipo	Contiene	No contiene	Uso típico
Archivo de configuración `sysupgrade -b`	`/etc/config` y los archivos de `sysupgrade.conf`	firmware, paquetes instalados, disco completo	restaurar los ajustes tras reinstalar o actualizar
Lista de paquetes	nombres, versiones, feeds	binarios de los paquetes	lista de comprobación para reinstalar
Imagen completa o copia de la VM	disco o VM completos	nada (más grande)	revertir la máquina entera o sustituir el disco

Una copia de la configuración no es una copia del firmware. Restaurar la configuración no reinstalará los paquetes que hayas eliminado.

Antes de la copia

Shell del routerRegistra versión, target y lista de paquetes

cat /etc/openwrt_release
cat /etc/apk/arch 2>/dev/null
apk list --installed > /tmp/packages-$(date +%F).txt
wc -l /tmp/packages-$(date +%F).txt
sysupgrade -l

Este laboratorio: 25.12.6, x86/64, 239 paquetes instalados; sysupgrade -b archivó 59 entradas.

EsperadoSabes de qué versión, target y arquitectura proviene la copia.

Shell del routerCrea el archivo de configuración

sysupgrade -b /tmp/backup-$(date +%F).tar.gz
ls -lh /tmp/backup-*.tar.gz
tar -tzf /tmp/backup-$(date +%F).tar.gz | head
sha256sum /tmp/backup-$(date +%F).tar.gz

Este laboratorio: 4,2 MB, 59 entradas, incluidas etc/config/network, dhcp, firewall, openclash, sqm.

El archivo puede contener contraseñas de Wi-Fi, credenciales PPPoE y configuración de DDNS o proxy. No lo subas a una nube pública ni a un repositorio; trátalo como información sensible.

EsperadoUn .tar.gz verificable copiado fuera del dispositivo.

OrdenadorCopia el archivo fuera del dispositivo

# pull from the router to the admin machine
scp [email protected]:/tmp/backup-2026-10-20.tar.gz ./
sha256sum backup-2026-10-20.tar.gz

No lo dejes solo en /tmp: un reinicio lo pierde y reinstalar el firmware seguro lo borra.

EsperadoExiste una copia aunque el dispositivo quede inutilizable o se reinstale el firmware.

Tres vías de restauración

1. Restauración de la misma versión en ejecución (este laboratorio)

sysupgrade -r /tmp/backup-2026-10-20.tar.gz

-r restaura la configuración y termina; no instala firmware. Después reinicia los servicios pertinentes o reinicia el equipo para que red, DHCP y DNS se recarguen.

Este laboratorio escribió network.lan.e2_marker='before-restore'; tras sysupgrade -r el marcador desapareció, la LAN seguía en 192.168.1.2/24, HTTP respondió 200 y SSH funcionó.

2. Restauración durante la reinstalación o actualización

sysupgrade -f /tmp/backup-2026-10-20.tar.gz <firmware.img>

-f restaura la configuración durante una actualización; no trates la copia como firmware ni restaures a ciegas entre versiones o targets distintos.

3. Reversión de la VM o imagen completa

PVE usa vzdump o instantáneas para restaurar el disco y la configuración de toda la VM; eso revierte firmware + paquetes + configuración, pero es más grande y puede sobrescribir datos nuevos. Los archivos de configuración y las copias de la máquina completa no se sustituyen entre sí.

Verifica tras restaurar

OrdenadorAcceso de administración

ping -c 2 192.168.1.2
curl -sSI --max-time 5 http://192.168.1.2/ | head -3
ssh [email protected] 'uci show network.lan | grep ipaddr'

HTTP 200 no demuestra que DHCP funcione;
poder entrar por SSH no demuestra que la configuración de LuCI sea correcta;
los clientes deben renovar y recibir una dirección del rango restaurado.

EsperadoComprueba al menos una vez la IP de la LAN, HTTP, SSH y DHCP.

Shell del routerRed, DHCP y DNS

uci show network.lan
uci show dhcp.lan
ubus call network.interface.lan status
logread | grep -Ei 'dnsmasq|dhcp|netifd' | tail -30

Reinicia si hace falta:

/etc/init.d/network reload
/etc/init.d/dnsmasq restart

EsperadoLa configuración restaurada surte efecto de verdad, no solo se extrajeron los archivos.

Shell del routerPaquetes

apk list --installed | wc -l
apk list --installed | grep -E 'openclash|sqm|adguard|luci-app' || true

Un archivo de configuración no contiene binarios. Tras reinstalar el firmware, reinstala desde la lista de paquetes y los feeds. La configuración de OpenClash, SQM o AGH puede seguir existiendo, pero los programas y módulos del kernel deben reinstalarse y verificarse.

EsperadoSabes qué paquetes hay que reinstalar; restaurar la configuración no restaura los paquetes.

Fallos comunes

Sigue la configuración anterior tras restaurar

no se reiniciaron los servicios o el dispositivo después de sysupgrade -r;
restauraste otro archivo;
un comando UCI posterior la sobrescribió;
el archivo no contiene ese fichero (revisa sysupgrade -l o tar -tzf).

No puedo acceder tras restaurar

la copia procede de otra subred LAN;
DHCP o el cortafuegos no se recargaron;
el archivo contiene contraseñas o ajustes SSH antiguos;
usa la consola: ip -4 addr show br-lan; no restablezcas de fábrica de inmediato.

Los paquetes no volvieron

las copias de configuración no contienen archivos de paquetes;
el feed o la versión no coinciden;
reinstala luci-app-* y los módulos del kernel;
«la configuración existe» no significa «el programa está instalado».

Restauración entre versiones

la versión, el target o la arquitectura no coinciden;
opciones renombradas o eliminadas en la nueva versión;
prueba primero en una VM;
conserva el firmware anterior y una copia de la máquina completa para revertir.

Ejecución de laboratorio E2 (2026-10-20)

Entorno: OpenWrt 25.12.6 x86 VM 200; LAN 192.168.1.2/24; apk; 239 paquetes instalados.
sysupgrade -b /tmp/backup-e2.tar.gz: 4,2 MB, 59 entradas; tar -tzf mostró etc/config/network, dhcp, firewall, openclash, sqm.
Se escribió network.lan.e2_marker='before-restore'; tras sysupgrade -r el marcador desapareció, la LAN seguía en .2, HTTP 200 y SSH funcionó.
No probado: restauración de una copia completa de PVE, restauración entre versiones, reinstalación de paquetes, corte de energía o dispositivo inutilizado en hardware real.
Receta: tests/recipes/backup-restore-25.12.md.

Fuentes y revisión

Esto es E2 parcial: se probaron la copia y restauración de configuración de la misma versión y el acceso de administración; no la máquina completa, entre versiones ni la reconstrucción de paquetes.
Los archivos de configuración contienen datos sensibles; no los subas a un repositorio ni los compartas.
Sin revisor independiente; las conclusiones se limitan a este entorno de VM.

Fuentes

Router.Homes

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