Eine Favoritenseite die man selbst erweitern kann
Find a file
flessinb 1e5ce2c20c Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild
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>
2026-11-13 07:57:08 +01:00
android Links teilen: Android-Teilen-Menü, PWA share_target, Bookmarklet 2026-11-12 22:42:20 +01:00
bin Angemeldet bleiben: eigene Sitzungsablage, Cookie 30 Tage ab letzter Nutzung 2026-11-13 06:44:37 +01:00
deploy Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild 2026-11-13 07:57:08 +01:00
docs Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild 2026-11-13 07:57:08 +01:00
lib Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild 2026-11-13 07:57:08 +01:00
public Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild 2026-11-13 07:57:08 +01:00
tests Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild 2026-11-13 07:57:08 +01:00
.gitignore Portal · FlessingLabs: Bereiche, Favoriten, Statusverlauf, Heimnetz-Adressen, Gästemodus 2026-11-12 22:06:16 +01:00
README.md Hintergrund & Darstellung: animierte Vorlagen, eigener Verlauf, eigenes Bild 2026-11-13 07:57:08 +01:00

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-Cookie HttpOnly, SameSite=Strict.
  • X-Forwarded-For wird nur von TRUSTED_PROXIES akzeptiert, 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