Frieren: Il micro-framework per gadget di sicurezza

Descrizione

Frieren è un framework per eseguire strumenti di sicurezza su router OpenWrt e Single Board Computer (SBC). Fornisce un pannello web con gestione WiFi, moduli installabili, un terminale integrato e un gestore di pacchetti. Lo stack è un backend PHP API con un frontend React, progettato per essere abbastanza leggero per dispositivi embedded rimanendo comunque estensibile tramite moduli di terze parti.

Caratteristiche

• Gestione WiFi — Crea, modifica e rimuovi interfacce wireless. Scansiona reti, configura radio, modifica la configurazione UCI raw.
• Rete — Gestisci interfacce di rete, visualizza i lease DHCP ed esegui diagnostica di connettività.
• Sistema di moduli — Installa, rimuovi e fissa moduli di terze parti da un repository remoto. I moduli vengono caricati dinamicamente come bundle UMD.
• Gestore pacchetti — Installa e rimuovi pacchetti opkg direttamente dal pannello web.
• Terminale integrato — Terminale web (ttyd) accessibile dal pannello.
• Strumenti di sistema — Dashboard con statistiche di sistema, elenco dispositivi USB, utilizzo del filesystem, visualizzatore syslog, diagnostica e controllo servizi init.d.
• Impostazioni — Configura hostname, fuso orario, password utente e tema del pannello.
• Estensibile — Scaffolding di nuovi moduli con frieren-module-template. Controller PHP + frontend React per modulo.

Componenti

• frieren-back — Micro-framework PHP. API JSON POST con autenticazione a sessione, CSRF, integrazione configurazione UCI e mini ORM.
• frieren-front — SPA React (Vite, Wouter, Jotai, React Query). Supporta il caricamento dinamico di moduli UMD.
• frieren-module-template — Strumento di scaffolding per sviluppare moduli di terze parti con dipendenze condivise tramite globali window.
• frieren-terminal — @frieren/terminal-core, una libreria TypeScript/xterm.js integrata nel frontend. Fornisce il client terminale ttyd live, un visualizzatore di log in sola lettura e i temi terminale condivisi.
• tools — Utility di sviluppo: proxy API di sviluppo, script di deploy su dispositivo, client di test API e un minificatore PHP.

Repository correlati

• Frieren Modules: Contiene moduli sviluppati dalla comunità basati su frieren-module-template. Questo repository è una risorsa per gli utenti che desiderano estendere le funzionalità della propria installazione Frieren con funzionalità aggiuntive.
• Frieren Release: Ospita gli installer per distribuire versioni precompilate di Frieren. Questo repository è ideale per gli utenti che desiderano installare Frieren rapidamente e facilmente senza passare attraverso il processo di compilazione.
• Frieren Modules Release: Pipeline di build per il catalogo dei moduli — genera l'indice modules.json e i tarball di rilascio per modulo che il pannello installa.

Installazione

Frieren funziona su OpenWrt (build ufficiali, non fork). Può essere installato tramite uno script automatizzato o compilato manualmente.

Installazione rapida

Per un'installazione rapida e semplice, esegui il seguente comando nel tuo terminale. Questo script gestirà tutte le configurazioni e i passaggi di configurazione necessari:

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

Nuovo su questo? Inizia qui. Se non sei sicuro di cosa sia OpenWrt, come installarlo o come aprire il pannello successivamente, segui la guida passo-passo adatta ai principianti: FAQ di Installazione — ti accompagna in tutto, da un dispositivo pulito fino al login.

Compilazione manuale

Ogni componente all'interno del progetto Frieren (frieren-back, frieren-front e frieren-module-template) ha il proprio file README.md dettagliato con istruzioni specifiche di build e installazione. Fai riferimento a questi file nelle rispettive directory per una guida più dettagliata.

Sviluppo di moduli

Usa frieren-module-template per creare lo scaffold di nuovi moduli. Esegui yarn wizard per impostare un nuovo modulo, sviluppa la tua funzionalità, poi yarn build per compilare un bundle UMD. Consulta il README del template del modulo per i dettagli.

Licenza

Questo progetto è concesso in licenza secondo i termini della PolyForm Noncommercial License 1.0.0.

L'uso non commerciale è consentito. L'uso commerciale non è permesso sotto questa licenza. L'uso commerciale richiede una licenza commerciale separata dall'autore.

Per licenze commerciali, contatta: [email protected]

Contribuire

Contributi benvenuti — nuove funzionalità, correzioni di bug o moduli. Consulta il README di ogni componente per le istruzioni di build.

Autori

• Sviluppatore principale: DSR! - [email protected]

Supporta lo sviluppo

Se trovi utile Frieren, considera di supportare lo sviluppo. Le donazioni finanziano l'hardware per i test e il lavoro continuo. Invia tramite Binance o unisciti a Patreon per aggiornamenti e build esclusivi.