Frieren: Das Mikro-Framework für Sicherheits-Gadgets

Beschreibung

Frieren ist ein Framework zum Ausführen von Sicherheitstools auf OpenWrt-Routern und Single-Board-Computern (SBCs). Es bietet ein Webpanel mit WLAN-Verwaltung, installierbaren Modulen, einem integrierten Terminal und einem Paketmanager. Der Stack besteht aus einer PHP-Backend-API mit einem React-Frontend, das leichtgewichtig genug für eingebettete Geräte ist und dennoch durch Drittanbietermodule erweiterbar bleibt.

Funktionen

• WLAN-Verwaltung — Drahtlose Schnittstellen erstellen, bearbeiten und entfernen. Netzwerke scannen, Funkmodule konfigurieren, rohe UCI-Konfiguration bearbeiten.
• Netzwerk — Netzwerkschnittstellen verwalten, DHCP-Leases anzeigen und Konnektivitätsdiagnosen durchführen.
• Modulsystem — Module von Drittanbietern aus einem entfernten Repository installieren, entfernen und anheften. Module werden dynamisch als UMD-Bundles geladen.
• Paketmanager — opkg-Pakete direkt über das Webpanel installieren und entfernen.
• Integriertes Terminal — Webbasiertes Terminal (ttyd), das über das Panel zugänglich ist.
• Systemtools — Dashboard mit Systemstatistiken, USB-Geräteliste, Dateisystemnutzung, Syslog-Viewer, Diagnose und init.d-Dienststeuerung.
• Einstellungen — Hostname, Zeitzone, Benutzerpasswort und Panel-Theme konfigurieren.
• Erweiterbar — Neue Module mit frieren-module-template erstellen. PHP-Controller + React-Frontend pro Modul.

Komponenten

• frieren-back — PHP-Mikro-Framework. JSON-POST-API mit Sitzungsauthentifizierung, CSRF, UCI-Konfigurationsintegration und einem Mini-ORM.
• frieren-front — React SPA (Vite, Wouter, Jotai, React Query). Unterstützt dynamisches Laden von UMD-Modulen.
• frieren-module-template — Scaffolding-Tool zur Entwicklung von Drittanbietermodulen mit gemeinsamen Abhängigkeiten über window-Globals.
• frieren-terminal — @frieren/terminal-core, eine TypeScript/xterm.js-Bibliothek, die im Frontend gebündelt ist. Bietet den Live-ttyd-Terminal-Client, einen schreibgeschützten Log-Viewer und die gemeinsamen Terminal-Themes.
• tools — Entwicklungshilfen: Dev-API-Proxy, Device-Deploy-Skript, API-Test-Client und ein PHP-Minifier.

Verwandte Repositories

• Frieren Modules: Enthält von der Community entwickelte Module basierend auf der frieren-module-template. Dieses Repository ist eine Ressource für Benutzer, die die Funktionalität ihrer Frieren-Installation mit zusätzlichen Funktionen erweitern möchten.
• Frieren Release: Enthält die Installationsprogramme zum Bereitstellen vorkompilierter Versionen von Frieren. Dieses Repository ist ideal für Benutzer, die Frieren schnell und einfach installieren möchten, ohne den Build-Prozess durchlaufen zu müssen.
• Frieren Modules Release: Build-Pipeline für den Modulkatalog – generiert den modules.json-Index und die modulspezifischen Release-Tarballs, die das Panel installiert.

Installation

Frieren läuft auf OpenWrt (offizielle Builds, keine Forks). Es kann über ein automatisiertes Skript installiert oder manuell kompiliert werden.

Schnellinstallation

Für eine schnelle und einfache Installation führen Sie den folgenden Befehl in Ihrem Terminal aus. Dieses Skript übernimmt alle notwendigen Konfigurationen und Einrichtungsschritte:

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

Neu hier? Hier starten. Wenn Sie nicht sicher sind, was OpenWrt ist, wie Sie es flashen oder wie Sie das Panel danach öffnen, folgen Sie der schrittweisen, anfängergeeigneten Installations-FAQ — sie führt Sie durch alles von einem sauberen Gerät bis zum Einloggen.

Manuelle Kompilierung

Jede Komponente innerhalb des Frieren-Projekts (frieren-back, frieren-front und frieren-module-template) verfügt über eine eigene detaillierte README.md-Datei mit spezifischen Build- und Installationsanweisungen. Bitte lesen Sie diese Dateien in ihren jeweiligen Verzeichnissen für eine genauere Anleitung.

Modulentwicklung

Verwenden Sie frieren-module-template, um neue Module zu erstellen. Führen Sie yarn wizard aus, um ein neues Modul einzurichten, entwickeln Sie Ihre Funktion, und kompilieren Sie dann mit yarn build ein UMD-Bundle. Details finden Sie in der Modulvorlage-README.

Lizenz

Dieses Projekt ist unter der PolyForm Noncommercial License 1.0.0 lizenziert.

Nicht-kommerzielle Nutzung ist erlaubt. Kommerzielle Nutzung ist unter dieser Lizenz nicht gestattet. Kommerzielle Nutzung erfordert eine separate kommerzielle Lizenz vom Autor.

Für kommerzielle Lizenzen kontaktieren Sie: [email protected]

Mitwirken

Beiträge sind willkommen – neue Funktionen, Fehlerbehebungen oder Module. Siehe die README jeder Komponente für Build-Anweisungen.

Autoren

• Leitender Entwickler: DSR! - [email protected]

Entwicklungsunterstützung

Wenn Sie Frieren nützlich finden, erwägen Sie bitte, die Entwicklung zu unterstützen. Spenden finanzieren Testhardware und laufende Arbeiten. Senden Sie über Binance oder treten Sie Patreon bei für exklusive Updates und Builds.