Cómo solucionar problemas de OpenWRT

 Le pregiuntamos a Gemini, la inteligencia artificial de Google cómo solucionar problemas de OpenWRT

Explicanos detalladamente cómo solucionar problemas de OpenWRT

Solucionar problemas en OpenWRT requiere un enfoque metódico, ya que al ser una distribución de Linux completa para routers, los fallos pueden ir desde una mala configuración de red hasta la saturación del almacenamiento interno.

A continuación, te presentamos una guía detallada para diagnosticar y recuperar tu dispositivo.

1. El "Modo a Prueba de Fallos" (Failsafe Mode) 🚨

Este es el paso más importante cuando has perdido el acceso al router (LuCI no carga y el SSH no conecta). El modo Failsafe carga un entorno mínimo con una IP estática predefinida, ignorando tus configuraciones corruptas.

Cómo entrar en Failsafe:

Desconecta el router de la corriente.

Vuelve a conectarlo y observa los LEDs. Cuando el LED de "Power" o "Status" comience a parpadear rápidamente, presiona repetidamente el botón Reset (o cualquier botón frontal).

Si el parpadeo se vuelve aún más rápido, has entrado en Failsafe.

Cómo acceder:

Conecta tu PC directamente al puerto LAN del router.

Configura la IP de tu PC manualmente a 192.168.1.2 con máscara 255.255.255.0.

Accede por terminal (SSH no funciona en este modo, usa Telnet):

Bash

telnet 192.168.1.1

Una vez dentro, puedes limpiar la configuración corrupta para volver a los valores de fábrica:

Bash

firstboot && reboot

2. Diagnóstico mediante Logs y Mensajes del Kernel

Si tienes acceso al router pero algo no funciona (el Wi-Fi se cae, el túnel VPN no conecta), los logs son tu mejor herramienta.

Comandos esenciales:

logread : Muestra los eventos del sistema (servicios, conexiones, errores de software).

Bash

logread -f # "Sigue" el log en tiempo real mientras intentas reproducir el error.

dmesg : Muestra los mensajes del kernel (errores de hardware, controladores de radio, detección de puertos USB).

Bash

dmesg | tail -n 20

3. Problemas de Red y Configuración de Interfaces 

OpenWRT gestiona la red mediante el archivo /etc/config/network. Un error de sintaxis aquí puede dejarte sin internet.

Verificación de archivos críticos:

Revisar la configuración:

Bash

cat /etc/config/network

Asegúrate de que la interfaz lan tenga la IP correcta y que la wan esté configurada según tu ISP (DHCP, PPPoE, etc.).

Reiniciar el subsistema de red: Si haces cambios por terminal, aplícalos sin reiniciar el router:

Bash

/etc/init.d/network restart

Problemas comunes de DNS:

Si puedes hacer ping a una IP (como 8.8.8.8) pero no puedes navegar por dominios, el problema es el servidor DNS. Verifica el archivo resolutor:

Bash

cat /tmp/resolv.conf.d/resolv.conf.auto

4. Almacenamiento Lleno (Overlay Full) 💾

Un problema muy frecuente en routers con poca memoria flash (4MB u 8MB) es llenar la partición /overlay al instalar paquetes. Cuando esto sucede, los cambios en la configuración no se guardan o el router entra en un ciclo de reinicios (bootloop).

Diagnóstico:

Ejecuta el comando:

Bash

df -h Si /overlay está al 100%, debes borrar archivos o paquetes:

Limpiar caché de opkg: rm -rf /var/opkg-lists/*

Eliminar paquetes pesados:

Bash

opkg remove luci-app-[nombre-del-paquete]

5. Tabla de Referencia para Solución Rápida

Síntoma	Posible Causa	Acción Recomendada
No hay acceso web (LuCI)	El servicio uhttpd se detuvo.	service uhttpd restart por SSH.
Wi-Fi invisible	Canal no soportado o radio "disabled".	Revisar /etc/config/wireless.
Paquetes no instalan	Falta de espacio o lista no actualizada.	opkg update y revisar df -h.
Cambios no se guardan	Partición overlay llena o de solo lectura.	mount -o remount,rw / o liberar espacio.

6. El Último Recurso: Sysupgrade por Terminal 

Si el sistema está muy inestable, lo mejor es reinstalar el firmware "limpio". Si tienes el archivo .bin en tu PC, pásalo al router vía SCP y ejecútalo:

Bash

sysupgrade -n /tmp/nombre_del_firmware.bin

La opción -n borra todas las configuraciones previas (recomendado para solucionar problemas persistentes).

¿Te gustaría que revisáramos la sintaxis de algún archivo de configuración específico o que te ayude a configurar el acceso vía puerto serie (TTL) para un router brickeado?