Pro Person gespeichert (users.appearance), lokal zwischengespeichert für sofortige Anzeige. Vorlagen: Polarlicht, Ozean, Sternenhimmel, Abendrot, Lichter. Eigenes Bild wird serverseitig mit GD neu kodiert (JPEG, max. 2560 px, ohne Metadaten) und nur der eigenen Person ausgeliefert. Hell/Dunkel erzwingbar, Animation abschaltbar, prefers-reduced-motion wird beachtet. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| android | ||
| bin | ||
| deploy | ||
| docs | ||
| lib | ||
| public | ||
| tests | ||
| .gitignore | ||
| README.md | ||
Portal · FlessingLabs
Startseite für das Heimnetz flessinghome.de: Links in frei definierbaren Bereichen, mit Erreichbarkeits-Check,
Benutzern und Rollen, persönlichen Favoriten, Gästeseite und Android-App.
Live: https://portal.flessinghome.de (über proxy64 → 192.168.20.211:3199)
Funktionen
- Bereiche frei anlegen (Name, Icon, Farbe, Reihenfolge) und festlegen, wer sie sieht: Rollen und/oder einzelne Personen.
- Rollen
- Admin: alles, plus Benutzerverwaltung und Gästemodus
- Erwachsene: Bereiche und Links verwalten, die sie selbst sehen oder die für Kinder gedacht sind
- Kind: freigegebene Bereiche ansehen
- Persönlich: Favoriten (★) für jeden; private Links, die nur die Person selbst sieht; eigene Reihenfolge (⇅ Anordnen, Drag & Drop oder ‹ ›) und einklappbare Bereiche – gespeichert pro Person, auf allen Geräten.
- Zwei Adressen pro Link: Internet und Heimnetz. Zu Hause wird automatisch die Heimnetz-Adresse geöffnet (Erkennung über die Client-IP hinter proxy64), umschaltbar über den Knopf 🏠/🌍.
- Erreichbarkeit: Hintergrundprüfung aller Adressen alle 2 Minuten (systemd-Timer), Verlauf 24 h je Karte, 7 Tage Aufbewahrung. Zustände: erreichbar, Anmeldung erforderlich, Seite fehlt, Dienstfehler, unerwartet, Zertifikat ungültig, nicht erreichbar, nicht geprüft, veraltet. Erwartete HTTP-Codes pro Link; TLS-Prüfung an (Ausnahme nur pro Heimnetz-Adresse). Erlaubte Ziel-Netze/Ports und Parallelität begrenzt, Weiterleitungen werden einzeln geprüft. Hinweis: geprüft wird vom Server aus, nicht vom Endgerät.
- Hintergrund & Darstellung pro Person: sanft animierte Vorlagen (Polarlicht, Ozean, Sternenhimmel, Abendrot, Lichter), eigener Farbverlauf oder eigenes Bild; Abdeckung für Lesbarkeit, Hell/Dunkel/Automatisch, Animation abschaltbar (bei „Bewegung reduzieren“ im System automatisch aus).
- Papierkorb: gelöschte Links und Bereiche 30 Tage wiederherstellbar.
- Import & Export: Browser-Lesezeichen (HTML) und Portal-JSON einlesen – mit Vorschau und Dubletten-Erkennung; Export als JSON-Sicherung oder Browser-Lesezeichen.
- Gästemodus: mehrere Gäste-Links mit Namen, Ablaufdatum (1 Tag, Wochenende, Woche, Monat, Datum, unbegrenzt), eigener Bereichsauswahl und WLAN ja/nein. Ohne Anmeldung über Link/QR-Code, nur Internet-Adressen. Gespeichert wird nur ein Hash – der Link ist nur direkt nach dem Anlegen sichtbar; jederzeit neu erzeugbar.
- Links teilen: „Teilen → Portal“ in der Android-App (ab 1.2) und der installierten Web-App, Bookmarklet für den PC. Öffnet den Link-Dialog vorausgefüllt, gespeichert wird erst nach Bestätigung.
- Anmeldung mit „Angemeldet bleiben“ (30 Tage ab letzter Nutzung, sonst bis zum Schließen des Browsers), optional 2FA (TOTP), Sperre nach 8 Fehlversuchen / 15 min pro IP. Passwortwechsel, 2FA-Änderung und Admin-Reset melden andere Geräte ab; „Auf anderen Geräten abmelden“ im Menü.
- PWA (installierbar) und Android-App (WebView,
android/).
Aufbau
public/ ausgelieferte Dateien (nginx-Root) – index.html, app.js, style.css, gast.*, api.php, sw.js
lib/ bootstrap.php (Speicher, Rechte, Netz, TOTP), status.php (Prüfung + Verlauf), config.php (Standardwerte)
bin/check.php Hintergrundprüfung (CLI), bin/migrate.php (Umstellung v1 → v2)
android/ WebView-App + build.sh (ohne Gradle, nur Android-SDK)
deploy/ nginx-Site, systemd-Service und -Timer
tests/ ./tests/run.sh – API-Tests mit eigenem Testserver und Wegwerf-Daten
docs/ BETRIEB.md (Daten, Einstellungen, Migrationen, Wiederherstellung), Pläne
Mehr zu Einstellungen, Migrationen und Wiederherstellung: docs/BETRIEB.md. Umgesetzter Plan: befristete Gäste-Links und Teilen aus Android.
Daten (nicht im Repo): /var/lib/portal/ – users.json, areas.json, bookmarks.json, settings.json,
trash.json, guests.json, optional config.json, status.sqlite, Sitzungen in sessions/, Hintergrundbilder in backgrounds/. Eigentümer www-data, Rechte 640.
Installation
# Daten-Verzeichnis
install -d -o www-data -g www-data -m 750 /var/lib/portal
# nginx
cp deploy/nginx-portal.conf /etc/nginx/sites-available/portal
ln -s /etc/nginx/sites-available/portal /etc/nginx/sites-enabled/portal
nginx -t && systemctl reload nginx
# Hintergrundprüfung
cp deploy/portal-check.{service,timer} /etc/systemd/system/
systemctl daemon-reload && systemctl enable --now portal-check.timer
Ersten Admin anlegen (danach alles in der Oberfläche):
sudo -u www-data php -r 'require "lib/bootstrap.php"; mutate(F_USERS, function(&$u){ $u[] = ["id"=>newId(),
"username"=>"admin","name"=>"Admin","role"=>"admin","favorites"=>[],
"hash"=>password_hash(readline("Passwort: "), PASSWORD_DEFAULT)]; });'
Anpassbar in lib/bootstrap.php: TRUSTED_PROXIES (IP von proxy64) und HOME_HOSTNAME (öffentlicher Name des Anschlusses).
Android-App
./android/build.sh <versionCode> <versionName> # z. B. ./android/build.sh 3 1.2
Benötigt JDK 17 und Android-SDK unter /opt/android-build (siehe Kopf von android/build.sh).
Ergebnis landet unter public/download/portal.apk (im Portal-Menü verlinkt).
Der Signaturschlüssel liegt in /etc/portal/ – sichern, nie ins Repo. Ohne ihn sind keine Updates der installierten App möglich.
Sicherheit
- Keine Zugangsdaten oder Daten im Repo; Passwörter mit
password_hash, TOTP-Geheimnisse nur in/var/lib/portal. - POST-Anfragen brauchen den Header
X-Portal: 1(CSRF-Schutz), Session-CookieHttpOnly,SameSite=Strict. X-Forwarded-Forwird nur vonTRUSTED_PROXIESakzeptiert, und nur der rechte Eintrag zählt.- Die Statusprüfung ruft nur gespeicherte Links auf (keine freien URLs von außen).
© Flessing Labs · flessinglabs.com