Frieren: El micro-framework para gadgets de seguridad

Descripción

Frieren es un framework para ejecutar herramientas de seguridad en routers OpenWrt y computadoras de placa única (SBC). Proporciona un panel web con gestión de WiFi, módulos instalables, un terminal integrado y un gestor de paquetes. La pila tecnológica es una API backend en PHP con un frontend en React, diseñada para ser lo suficientemente ligera para dispositivos embebidos y, al mismo tiempo, extensible mediante módulos de terceros.

Características

• Gestión de WiFi — Crea, edita y elimina interfaces inalámbricas. Escanea redes, configura radios, edita la configuración UCI sin procesar.
• Red — Gestiona interfaces de red, consulta concesiones DHCP y ejecuta diagnósticos de conectividad.
• Sistema de Módulos — Instala, elimina y fija módulos de terceros desde un repositorio remoto. Los módulos se cargan dinámicamente como paquetes UMD.
• Gestor de Paquetes — Instala y elimina paquetes opkg directamente desde el panel web.
• Terminal Integrado — Terminal basada en web (ttyd) accesible desde el panel.
• Herramientas del Sistema — Tablero con estadísticas del sistema, listado de dispositivos USB, uso del sistema de archivos, visor de syslog, diagnósticos y control de servicios init.d.
• Ajustes — Configura el nombre de host (hostname), la zona horaria, la contraseña de usuario y el tema del panel.
• Extensible — Genera nuevos módulos con frieren-module-template. Controlador PHP + frontend React por módulo.

Componentes

• frieren-back — Micro-framework PHP. API JSON POST con autenticación por sesión, CSRF, integración de configuración UCI y un mini ORM.
• frieren-front — SPA en React (Vite, Wouter, Jotai, React Query). Soporta carga dinámica de módulos UMD.
• frieren-module-template — Herramienta de andamiaje para desarrollar módulos de terceros con dependencias compartidas mediante variables globales de window.
• frieren-terminal — @frieren/terminal-core, una librería TypeScript/xterm.js incluida en el frontend. Proporciona el cliente de terminal ttyd en vivo, un visor de registros de solo lectura y los temas de terminal compartidos.
• tools — Utilidades de desarrollo: proxy de API de desarrollo, script de despliegue en dispositivos, cliente de prueba de API y un minificador PHP.

Repositorios Relacionados

• Frieren Modules: Contiene módulos desarrollados por la comunidad basados en frieren-module-template. Este repositorio es un recurso para los usuarios que buscan ampliar la funcionalidad de su instalación de Frieren con características adicionales.
• Frieren Release: Aloja los instaladores para desplegar versiones precompiladas de Frieren. Este repositorio es ideal para los usuarios que deseen instalar Frieren de forma rápida y sencilla sin pasar por el proceso de compilación.
• Frieren Modules Release: Canal de compilación para el catálogo de módulos — genera el índice modules.json y los tarballs de lanzamiento por módulo desde los que instala el panel.

Instalación

Frieren se ejecuta en OpenWrt (compilaciones oficiales, no forks). Puede instalarse mediante un script automatizado o compilarse manualmente.

Instalación Rápida

Para una instalación rápida y sencilla, ejecuta el siguiente comando en tu terminal. Este script se encargará de todas las configuraciones y pasos de instalación necesarios:

wget -qO- https://raw.githubusercontent.com/xchwarze/frieren-release/master/install/install-openwrt.sh | sh

¿Nuevo en esto? Empieza aquí. Si no estás seguro de qué es OpenWrt, cómo flashearlo o cómo abrir el panel después, sigue la guía paso a paso, pensada para principiantes, FAQ de Instalación — te guía por todo el proceso, desde un dispositivo limpio hasta iniciar sesión.

Compilación Manual

Cada componente del proyecto Frieren (frieren-back, frieren-front y frieren-module-template) tiene su propio archivo README.md detallado con instrucciones específicas de compilación e instalación. Consulta estos archivos en sus respectivos directorios para obtener una guía más detallada.

Desarrollo de Módulos

Usa frieren-module-template para generar nuevos módulos. Ejecuta yarn wizard para configurar un nuevo módulo, desarrolla tu funcionalidad y luego yarn build para compilar un paquete UMD. Consulta el README de la plantilla de módulos para más detalles.

Licencia

Este proyecto está bajo la Licencia No Comercial PolyForm 1.0.0.

Se permite el uso no comercial. El uso comercial no está permitido bajo esta licencia. El uso comercial requiere una licencia comercial separada del autor.

Para licencias comerciales, contacta: [email protected]

Contribuciones

Se aceptan contribuciones — nuevas funciones, correcciones de errores o módulos. Consulta el README de cada componente para las instrucciones de compilación.

Autores

• Desarrollador Principal: DSR! - [email protected]

Apoya el Desarrollo

Si encuentras útil Frieren, considera apoyar su desarrollo. Las donaciones financian hardware de pruebas y el trabajo continuo. Envía donaciones vía Binance o únete a Patreon para obtener actualizaciones y compilaciones exclusivas.