1. Propósito
Actualizar OpenWrt significa reemplazar el firmware original del proveedor de un enrutador con el sistema operativo OpenWrt. OpenWrt es un sistema operativo basado en Linux para dispositivos de red integrados. Proporciona un sistema de archivos grabable, administración de paquetes, control de firewall, soporte VPN, VLAN, modelado de tráfico y administración avanzada de enrutadores más allá de lo que permite la mayoría del firmware original. El proyecto OpenWrt lo describe como un sistema operativo Linux para dispositivos integrados que reemplaza el firmware estático del proveedor con un sistema de archivos grabable y administración de paquetes.
Este documento explica cómo prepararse, elegir la imagen de firmware correcta, actualizar OpenWrt de forma segura, realizar la primera configuración de inicio y recuperarse de problemas comunes.
2. Seguridad y autorización
Actualice únicamente OpenWrt en un enrutador de su propiedad o que esté explícitamente autorizado a modificar. No actualice enrutadores propiedad de un ISP, empleador, escuela, hotel, propietario o proveedor de servicios administrados a menos que tenga permiso.
La actualización del firmware puede dañar permanentemente un enrutador si:
- Se utiliza la imagen incorrecta.
- La revisión del hardware no coincide.
- La energía se interrumpe durante el parpadeo.
- Se ignora un procedimiento de flasheo específico del dispositivo.
- Se omite incorrectamente un mecanismo de protección de firmware del proveedor.
- El enrutador tiene muy poca memoria flash o RAM para el OpenWrt moderno.
OpenWrt distingue entre instalación por primera vez desde el firmware del proveedor y actualización del sistema desde una instalación de OpenWrt existente. Una actualización del sistema reemplaza la instalación actual de OpenWrt y no es lo mismo que una instalación de fábrica por primera vez.
3. Conceptos clave
3.1 Imagen de fábrica
Normalmente se utiliza una imagen de fábrica cuando el enrutador todavía ejecuta el firmware original del fabricante.
Ejemplos típicos de nombres de archivos:
openwrt-...-factory.bin
openwrt-...-factory.img
openwrt-...-factory.trx
Utilice esto para:
- Firmware del proveedor → OpenWrt
La documentación de instalación de fábrica de OpenWrt describe el proceso inicial como descargar el firmware correcto, verificar el archivo descargado y actualizar el firmware.
3.2 Imagen de actualización del sistema
Se utiliza una imagen de actualización del sistema cuando OpenWrt ya está instalado y está actualizando o reinstalando OpenWrt.
Nombre de archivo típico:
openwrt-...-sysupgrade.bin
Utilice esto para:
- OpenWrt → más nuevo OpenWrt
- OpenWrt → reinstalación de la misma versión
- OpenWrt → reinicio limpio con nueva imagen OpenWrt
La documentación de sysupgrade de OpenWrt explica que sysupgrade reemplaza toda la instalación actual de OpenWrt, incluidas las particiones del kernel y del sistema de archivos.
3.3 Imagen instantánea
Una instantánea es una compilación de desarrollo. Puede que admita hardware más nuevo, pero es menos predecible que el firmware estable.
Utilice firmware estable a menos que:
- Su enrutador solo es compatible con instantáneas.
- Entiendes el riesgo.
- Te sientes cómodo recuperando el dispositivo.
- Sabes cómo instalar los paquetes faltantes manualmente.
El selector de firmware OpenWrt permite a los usuarios elegir una compilación estable o una compilación instantánea nocturna.
3.4 Imagen de recuperación
Algunos enrutadores requieren una imagen de recuperación especial o un método de recuperación del gestor de arranque. Esto puede implicar:
- TFTP
- Modo de rescate de proveedores
- Consola serie
- Servidor web de recuperación
- arranque initramfs
- recuperación USB
Los métodos de recuperación son específicos del dispositivo. No asuma que el proceso de recuperación de un enrutador se aplica a otro.
4. Lista de verificación previa al flash
Antes de actualizar OpenWrt, recopile la siguiente información.
4.1 Identificación del enrutador
Registro:
Brand:
Model:
Hardware revision:
Current firmware version:
Region variant:
Serial number:
MAC address:
La revisión del hardware es crítica. Por ejemplo, un enrutador marcado como v1, v2 y v3 puede requerir diferentes imágenes de firmware.
4.2 Copia de seguridad de la configuración de red
Guardar o captura de pantalla:
- Tipo de conexión WAN
- Nombre de usuario/contraseña PPPoE, si se utiliza
- Configuración de IP estática, si se usa
- Configuración de VLAN o IPTV
- subred LAN
- rango DHCP
- SSID de Wi-Fi
- contraseña wifi
- Reglas de reenvío de puertos
- Configuración de DNS
- Configuración de VPN
- Configuración de clonación de MAC, si se utiliza
Después de flashear, OpenWrt no conocerá automáticamente la configuración del firmware de su proveedor.
4.3 Preparación para la recuperación
Antes de flashear, busque el método de recuperación para su dispositivo exacto.
Guardar:
- Archivo de firmware del proveedor original
- Página del dispositivo OpenWrt
- Instrucciones de recuperación TFTP, si están disponibles
- Instrucciones a prueba de fallos
- Configuraciones de IP estática necesarias para la recuperación
- Secuencia de botones para el modo de recuperación
La documentación de recuperación de OpenWrt señala que algunos proveedores proporcionan funciones de rescate integradas en la partición de arranque de la ROM flash que permanecen disponibles incluso después de una actualización del firmware de OpenWrt.
4.4 Configuración física
Utilice esta configuración física:
- Computadora conectada por Ethernet
- Computadora conectada al puerto LAN del enrutador
- Enrutador conectado a una fuente de alimentación estable
- Wi-Fi desactivado en la computadora si es necesario
- No hay dispositivos innecesarios conectados
- No hay firmware parpadeando a través de Wi-Fi
No actualice el firmware durante un corte de energía, una tormenta, un uso inestable del generador o cuando el enrutador pueda desconectarse accidentalmente.
5. Encontrar el firmware OpenWrt correcto
5.1 Utilice el selector de firmware
Utilice el selector de firmware oficial OpenWrt para buscar el modelo exacto de su enrutador y la revisión de hardware. El selector de firmware está diseñado para descargar el firmware OpenWrt para un dispositivo seleccionado y elegir una versión estable o instantánea.
Buscar por:
- Marca del enrutador
- Modelo de enrutador
- Revisión de hardware
Términos de búsqueda de ejemplo:
TP-Link Archer C7 v5
GL.iNet GL-AR750S
Linksys EA8300
Netgear R7800
5.2 Utilice la tabla de hardware
La documentación de descargas de OpenWrt recomienda utilizar la Tabla de hardware o el Selector de firmware para localizar el firmware oficial para un dispositivo específico.
Comprobar:
- Versión compatible
- Método de instalación
- Problemas conocidos
- Imagen requerida
- Notas de recuperación
- Tamaño del destello
- Tamaño de RAM
- Soporte wifi
- Advertencias especiales
5.3 Elija firmware estable
Según la documentación de la versión actual de OpenWrt, la serie OpenWrt estable es 25.12, y 25.12.4 figura como la versión estable actual.
Utilice estable a menos que la página del dispositivo indique que necesita una instantánea.
6. Verificación del archivo de firmware
Antes de flashear, verifique que el archivo descargado no esté dañado.
Linux
sha256sum openwrt-*.bin
macos
shasum -a 256 openwrt-*.bin
WindowsPowerShell
Get-FileHash .\openwrt-*.bin -Algorithm SHA256
Compare el resultado con la suma de comprobación proporcionada por el directorio de descarga de OpenWrt o el selector de firmware. Si la suma de comprobación no coincide, no actualice el archivo.
7. Método de actualización A: instalación por primera vez desde el firmware del proveedor
Utilice este método cuando el enrutador todavía esté ejecutando el firmware original del fabricante.
Paso 1: descargue la imagen de fábrica
Utilice un archivo etiquetado como algo así:
factory.bin
factory.img
factory.trx
factory.chk
No utilice una imagen de actualización del sistema para la primera actualización a menos que la página OpenWrt específica del dispositivo lo indique explícitamente.
Paso 2: Conéctese por Ethernet
Conectar:
- Puerto Ethernet de la computadora → Puerto LAN del enrutador
Evite:
- Wi-Fi parpadeando
- El puerto WAN parpadea a menos que las instrucciones del dispositivo lo indiquen
- Adaptadores USB Ethernet con controladores inestables
Paso 3: inicie sesión en el firmware del proveedor
Las direcciones de enrutadores de proveedores comunes incluyen:
http://192.168.0.1
http://192.168.1.1
http://192.168.8.1
http://10.0.0.1
Inicie sesión con el nombre de usuario y la contraseña del administrador del firmware del proveedor.
Paso 4: abra la página de actualización de firmware
Nombres de menú comunes:
- Administración → Actualización de firmware
- Herramientas del sistema → Actualización de firmware
- Avanzado → Actualización de firmware
- Mantenimiento → Firmware
- Actualización del enrutador
- Carga manual de firmware
La documentación genérica de actualización de OpenWrt describe el uso de la interfaz web del firmware OEM y su opción de actualización de firmware para instalar la imagen de fábrica correcta de OpenWrt.
Paso 5: cargue la imagen de fábrica de OpenWrt
Antes de presionar actualizar, verifique:
- Modelo de enrutador correcto
- Revisión correcta del hardware.
- Región correcta
- Tipo de archivo correcto
- Suma de comprobación verificada
- Lanzamiento estable seleccionado
- Página del dispositivo marcada
Luego cargue el firmware.
Paso 6: espere a que se reinicie
No:
- Desenchufe la energía
- Presione restablecer
- Actualizar repetidamente
- Cerrar la tapa del portátil
- Desconectar Ethernet
- Interrumpir el proceso
Un flasheo normal puede tardar varios minutos dependiendo del enrutador.
Paso 7: acceda a OpenWrt
Después de reiniciar, configure su computadora en DHCP y abra:
http://192.168.1.1
La documentación de inicio de sesión de OpenWrt indica que el nombre de usuario administrativo predeterminado es root y que el campo de contraseña está inicialmente vacío hasta que establezca una contraseña.
8. Método de actualización B: actualizar OpenWrt existente utilizando LuCI
Utilice este método cuando OpenWrt ya esté instalado y LuCI esté disponible.
Paso 1: Descargue la imagen de Sysupgrade
Descargue la imagen de actualización del sistema correcta para su dispositivo exacto.
Ejemplo:
openwrt-...-sysupgrade.bin
Paso 2: inicie sesión en LuCI
Abierto:
http://192.168.1.1
Go to:
System → Backup / Flash Firmware
La documentación de actualización del sistema OpenWrt enumera la página Backup/Flash Firmware de LuCI como método de actualización de firmware estándar.
Paso 3: crea una copia de seguridad
Descargue una copia de seguridad de la configuración antes de actualizar.
Guárdalo en un lugar seguro:
- Computadora
- unidad externa
- Archivo adjunto del administrador de contraseñas
- Carpeta de documentación de administración
Paso 4: Cargue la imagen de Sysupgrade
Seleccione:
- Flashear nueva imagen de firmware
Cargue el archivo sysupgrade.
Utilice Mantener configuración solo si:
- La ruta de actualización es compatible
- La página del dispositivo no avisa
- No estás intentando realizar un reinicio limpio del enrutador
- Su configuración es buena
Utilice un reinicio limpio si su configuración no funciona o si está avanzando por una ruta de actualización riesgosa.
Paso 5: flashear y reiniciar
Confirme la imagen del firmware e inicie la actualización.
No interrumpa la energía.
Después de reiniciar, regrese a:
http://192.168.1.1
9. Método de actualización C: actualizar OpenWrt existente mediante SSH
Utilice este método si LuCI no está disponible o si prefiere flashear la línea de comandos.
Paso 1: copie el firmware al enrutador
Desde tu computadora:
scp openwrt-*-sysupgrade.bin root@192.168.1.1:/tmp/
Paso 2: SSH en el enrutador
ssh root@192.168.1.1
OpenWrt proporciona administración SSH para la gestión de enrutadores de línea de comandos.
Paso 3: crear copia de seguridad
sysupgrade -b /tmp/openwrt-backup.tar.gz
Copie la copia de seguridad a su computadora:
scp root@192.168.1.1:/tmp/openwrt-backup.tar.gz .
Paso 4: flashear manteniendo la configuración
sysupgrade /tmp/openwrt-*-sysupgrade.bin
Paso 5: Flashear y restablecer la configuración
Utilice esto cuando desee una instalación limpia:
sysupgrade -n /tmp/openwrt-*-sysupgrade.bin
La opción -n evita restaurar la configuración anterior.
10. Primera configuración de arranque
Después de flashear, conéctese a:
http://192.168.1.1
Iniciar sesión:
Username: root
Password: empty on first login
Las preguntas frecuentes iniciales de OpenWrt confirman que no hay una contraseña inicial establecida para root.
Establezca inmediatamente una contraseña.
10.1 Establecer contraseña raíz
En LuCI:
- Sistema → Administración → Contraseña del enrutador
Usando SSH:
passwd
Utilice una contraseña segura.
10.2 Configurar WAN
Tipos de WAN comunes:
- cliente DHCP
- IP estática
- PPPoE
- WAN etiquetada con VLAN
- Módem LTE/5G
- Conexión USB
Si su ISP usa PPPoE, ingrese el nombre de usuario y la contraseña de la configuración anterior de su enrutador.
10.3 Configurar LAN
La LAN OpenWrt predeterminada suele ser:
192.168.1.1/24
Cámbielo si su módem ascendente o su red existente también usa 192.168.1.0/24.
Ejemplo de LAN alternativa:
192.168.10.1
10.4 Configurar Wi-Fi
OpenWrt comúnmente desactiva Wi-Fi de forma predeterminada en dispositivos con puertos Ethernet por razones de seguridad.
Conjunto:
- código de país
- SSID
- Cifrado: WPA2/WPA3 si es compatible
- Frase de contraseña segura
No dejes Wi-Fi abierto.
10.5 Confirmar los valores predeterminados del firewall
OpenWrt normalmente permite el tráfico de LAN a WAN y bloquea el tráfico de WAN a LAN no solicitado de forma predeterminada.
No exponer:
- LuCI
- SSH
- Puertos de administración del enrutador
a Internet a menos que utilice un diseño de gestión seguro basado en VPN.
11. Endurecimiento posterior a la instalación
Lista de verificación de endurecimiento recomendada:
- Establecer contraseña de root
- Deshabilite el inicio de sesión SSH con contraseña si usa claves SSH
- No exponga LuCI a WAN
- No exponer SSH a WAN
- Utilice WPA2/WPA3
- Deshabilite WPS si está presente
- Mantenga el firmware actualizado
- Eliminar paquetes no utilizados
- Crear una red de invitados para los visitantes.
- Cree una red de IoT separada si es necesario
- Hacer una copia de seguridad de la configuración después de la instalación
- Método de recuperación de documentos
12. Problemas comunes y soluciones
12.1 No se puede acceder al enrutador después de flashear
Prueba:
- Configurar la computadora en DHCP
- Pruebe http://192.168.1.1
- Pruebe con otro puerto LAN
- Espere varios minutos más.
- Apague y encienda una vez después de esperar
- Utilice Ethernet, no Wi-Fi
Si DHCP falla, configure una IP estática:
Computer IP: 192.168.1.2
Subnet mask: 255.255.255.0
Gateway: 192.168.1.1
DNS: 192.168.1.1
Luego abre:
http://192.168.1.1
12.2 El firmware del proveedor rechaza el archivo OpenWrt
Causas probables:
- Tipo de imagen incorrecto
- Revisión de hardware incorrecta
- Región equivocada
- Archivo de firmware demasiado grande
- El proveedor bloquea el firmware de terceros
- Se requiere un método de instalación especial
- Restricción de firmware firmado
No fuerces el archivo. Regrese a la página OpenWrt específica del dispositivo.
12.3 LuCI falta después del flash
Algunas imágenes no incluyen LuCI, especialmente instantáneas o compilaciones personalizadas.
Para OpenWrt 25.12 y posteriores:
apk update
apk add luci
Para OpenWrt 24.10 y versiones anteriores:
opkg update
opkg install luci
La documentación del paquete OpenWrt indica que OpenWrt 25.12 y versiones posteriores usan apk, mientras que 24.10 y versiones anteriores usan opkg.
12.4 Configuraciones incorrectas lo bloquearon
Utilice el modo a prueba de fallos. La documentación de seguridad de OpenWrt explica que el modo de seguridad y el restablecimiento de fábrica se utilizan cuando los problemas de configuración hacen que el dispositivo sea inaccesible.
Secuencia común de recuperación a prueba de fallos:
mount_root
firstboot
reboot -f
Esto borra la configuración y devuelve OpenWrt a su estado predeterminado.
12.5 Actualización fallida del firmware
Si no se puede acceder a LuCI o SSH, intente:
- Modo a prueba de fallos
- Restablecimiento de fábrica
- Modo de recuperación del proveedor
- recuperación TFTP
- Consola serie
OpenWrt recomienda probar primero el modo a prueba de fallos y el restablecimiento de fábrica cuando no se puede acceder a la interfaz después de problemas de configuración o actualización.
13. Descripción general de la recuperación TFTP
Algunos enrutadores pueden recuperar el firmware mediante TFTP.
Un proceso típico de recuperación TFTP implica:
- Configurar la computadora a una IP estática específica
- Cambie el nombre del archivo de firmware al nombre requerido
- Iniciar servidor o cliente TFTP
- Mantenga presionado el botón de reinicio/WPS
- Encienda el enrutador
- Espere a que el gestor de arranque solicite firmware
- Transferir firmware
- Espere a que parpadee automáticamente y reinicie
La documentación de recuperación TFTP de OpenWrt describe el uso de Ethernet, la alimentación del enrutador y el uso de una secuencia de botones específica del dispositivo para iniciar la recuperación del firmware.
Importante: los detalles de TFTP varían según el enrutador. Siempre revisa:
- IP de recuperación del enrutador
- IP de la computadora
- Nombre de archivo requerido
- Puerto Ethernet requerido
- Sincronización del botón
- Si el enrutador actúa como cliente o servidor TFTP
14. Cuándo no flashear OpenWrt
No actualice OpenWrt si:
- El enrutador no es tuyo
- El modelo no es compatible.
- La revisión del hardware no está clara.
- No puedes encontrar instrucciones de recuperación.
- El enrutador es su único acceso a Internet y no tiene un plan de respaldo
- El dispositivo tiene muy poca memoria flash/RAM para paquetes y superposiciones OpenWrt
- Necesita funciones exclusivas del proveedor que OpenWrt no admite
- No estás preparado para restablecer o recuperar el dispositivo.
15. Flujo de trabajo de actualización recomendado
Utilice este flujo de trabajo exacto para la mayoría de los enrutadores:
- Confirma que eres el propietario del enrutador.
- Identifique el modelo exacto y la revisión de hardware.
- Verifique la compatibilidad del dispositivo OpenWrt.
- Lea la página de instalación específica del dispositivo.
- Descargue la imagen estable de fábrica para realizar la instalación por primera vez.
- Descargue la imagen estable de actualización del sistema solo si OpenWrt ya está instalado.
- Verificar suma de verificación.
- Guarde la configuración actual del enrutador.
- Descargue el firmware del proveedor para la recuperación.
- Conéctese por Ethernet.
- Continúe con el método correcto.
- Espere a que se reinicie sin interrumpir la energía.
- Abra http://192.168.1.1.
- Inicie sesión como root con una contraseña vacía.
- Establezca la contraseña de root inmediatamente.
- Configure WAN, LAN, Wi-Fi y firewall.
- Haga una copia de seguridad de la configuración OpenWrt terminada.
- Pasos de recuperación de documentos.
16. Conclusión
Actualizar OpenWrt es el proceso de reemplazar el firmware original de un enrutador con un sistema operativo de enrutador flexible basado en Linux. Las partes más importantes no son comandos complicados; son preparación y precisión.
La instalación más segura depende de:
- Modelo de dispositivo correcto
- Revisión correcta del hardware.
- Tipo de firmware correcto
- Poder estable
- Conexión Ethernet
- Suma de comprobación verificada
- Método de recuperación conocido
Utilice una imagen de fábrica al realizar la instalación desde el firmware del proveedor. Utilice una imagen de sysupgrade cuando actualice una instalación de OpenWrt existente. Después de flashear, establezca inmediatamente la contraseña de root, configure WAN y Wi-Fi, evite exponer los servicios de administración a Internet y guarde una copia de seguridad funcional.