netgrip
Panel companion para OpenWrt que complementa LuCI con un dashboard Go+React para gestionar servicios (WiFi, VPN, QoS) mediante switches visuales, snapshots y rollback automático sin contenedores.
Ficha actualizada 22 sept 2026, 15:28 · upstream 22 sept 2026, 14:32 · release v0.72.18
Qué es netgrip
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
NetGrip es un panel de control ligero diseñado específicamente para routers OpenWrt, actuando como complemento visual y operativo a la interfaz LuCI existente. A diferencia de las soluciones basadas en contenedores que consumen recursos adicionales, NetGrip se despliega como un único binario estático embebido (~10 MB) escrito en Go, lo que garantiza una huella mínima de memoria y persistencia tras actualizaciones de firmware mediante sysupgrade.
La arquitectura se basa en tres pilares: reside directamente en el router sin virtualización, aplica cambios seguros mediante snapshots de configuración con rollback automático si fallan, y utiliza la sesión de autenticación de LuCI (rpcd) para evitar crear cuentas adicionales. El frontend está construido con React 19, TypeScript y Vite, embebido en el binario principal mediante go:embed.
Ofrece gestión completa de servicios comunes como WireGuard, OpenVPN, DNS, QoS (SQM), port forwarding y redes WiFi aisladas (invitados/IoT), junto con monitoreo en tiempo real de tráfico, estado del WAN/LAN y análisis de aplicaciones. Incluye un agente opcional NetPulse para telemetría de flota sin requerir instalación adicional.
- Gestión visual de servicios de red (WiFi, VPN, QoS) con un solo clic y rollback automático en caso de fallo.
- Monitoreo en tiempo real del tráfico WAN/LAN, estado de puertos Ethernet y clientes conectados con límites de ancho de banda.
- Despliegue sin contenedores ni Docker en routers ARM64/MIPSLE/x86_64 con OpenWrt 24.10 o 25.12.
- Integración con LuCI mediante paquete opcional luci-app-netgrip para acceso desde el menú de servicios.
- Binario único estático embebido (~10 MB) sin dependencias externas ni contenedores, optimizado para hardware limitado.
- Mecanismo de snapshots y rollback automático que deshace cambios fallidos en la configuración del router.
- Autenticación unificada con credenciales de LuCI (rpcd), evitando cuentas administrativas adicionales.
- Persistencia tras sysupgrade gracias a scripts postinst que registran el binario en /etc/sysupgrade.conf.
- API JSON completa para lectura/escritura de servicios y telemetría, útil para integraciones personalizadas.
- Requiere OpenWrt 24.10 o 25.12; no es compatible con versiones anteriores ni firmware propietario.
- No soporta despliegue en contenedores Docker ni Kubernetes, diseñado exclusivamente para entornos nativos.
- Depende de rpcd para autenticación; si el servicio rpcd falla, el panel no permite acceso.
- Sin base de datos externa; toda la información se gestiona directamente a través de UCI y archivos del sistema.
- El binario en modo bare (sin paquete) no sobrevive a actualizaciones de firmware sin reinstalación manual.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar ejecutando el script oficial install.sh que detecta arquitectura y gestor de paquetes (apk/opkg). Alternativamente, descargar paquetes .apk/.ipk desde releases. Usar puerto 8090 por defecto; ajustar con flag -port si hay conflicto. Verificar compatibilidad de arquitectura antes de instalar. Para actualizaciones, preferir paquetes oficiales para persistencia en sysupgrade.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.