quickinfo

Schlanke, vollständig offline-fähige Web-Überwachung für Ubuntu Bare-Metal-Server. Natives PHP + MySQL/MariaDB im Backend, Vanilla JS / HTML5 / CSS3 im Frontend – keine Frameworks, keine CDNs, keine externen Schriftarten oder Bibliotheken.

Funktionen

• CPU: Auslastung gesamt & pro Kern, Temperatur pro Kern (hwmon / lm-sensors / thermal_zone)
• NVIDIA GPU: Auslastung, Temperatur, VRAM, Leistungsaufnahme (nvidia-smi)
• Speicherplatz des Root-Dateisystems, Arbeitsspeicher, Load & Uptime
• systemd-Dienste: Status-Check konfigurierbarer Units, Verfügbarkeit der letzten 24 h, Verwaltung über das Web-Frontend (nach Login)
• Verlaufsgraphen für 1h · 3h · 24h · 3d · 14d – nativ auf HTML5 Canvas, Retina-scharf (devicePixelRatio), mit Tooltip, Fadenkreuz und ein-/ausblendbaren Serien
• Modernes Dark-Theme mit System-Schriftarten
• Sicherer Login: Session-basiert, password_hash(), CSRF-Token, Login-Throttling, HttpOnly/Secure/SameSite-Cookies, strikte Content-Security-Policy
• Time-Series-Speicherung mit automatischem Downsampling (10-Minuten-Buckets) und Cleanup
• VM-Erkennung: Läuft quickinfo in einer virtuellen Umgebung (VM/Container), werden die Temperatur-Sensoren sowie die zugehörige Anzeige und der Verlaufsgraph automatisch deaktiviert
• REST-API für ein Management-Board (/api/v1/…): schreibgeschützte JSON-Endpunkte mit Bearer-Token-Authentifizierung, konfigurierbarem CORS und Schlüsselverwaltung im Admin-Panel
• Docker-Host-Überwachung: optionaler Container-Tab auf der Hauptseite. Läuft quickinfo auf einem Docker-Host, werden die SSH-Zugangsdaten (Passwort oder privater SSH-Key) AES-256-GCM-verschlüsselt in der Datenbank hinterlegt. Der Container-Tab zeigt alle Container (inkl. gestoppter), je Container Auslastung (CPU, RAM, Netz, Block-I/O, PIDs), Mounts/Volumes, Netzwerkkonfiguration, Port-Weiterleitungen und die letzten Log-Einträge; Container lassen sich starten/stoppen/neu starten, mit eigenen Notizen versehen und per Drag & Drop in frei benannte Ordner sortieren.

Installation (One-Liner)

Voraussetzung ist PHP ≥ 8.5 (CLI + FPM) mit den Erweiterungen pdo_mysql und mbstring. Auf einem frischen Ubuntu-Server (empfohlen 22.04 / 24.04) installiert install.sh PHP 8.5 bei Bedarf über das PPA ppa:ondrej/php:

git clone https://github.com/dareinelt/quickinfo quickinfo && cd quickinfo && sudo bash install.sh

install.sh erledigt:

1. apt-Installation von nginx, PHP 8.5 (php8.5-fpm, php8.5-cli, php8.5-mysql, php8.5-mbstring; Paketquelle bei Bedarf ppa:ondrej/php), mysql-server (Fallback MariaDB), lm-sensors (inkl. sensors-detect --auto), sysstat und sshpass (für die Docker-Passwort-Authentifizierung über SSH)
2. Self-Signed-Zertifikat (10 Jahre, SAN mit Hostname & IP), Nginx mit HTTP→HTTPS-Redirect und PHP-FPM-Anbindung
3. Datenbank, DB-Benutzer, Schema (db.sql) und Admin-Benutzer mit zufälligem Passwort (wird am Ende ausgegeben)
4. Collector als systemd-Timer (minütlich), Dateirechte für /var/www/html/quickinfo
5. Erster API-Schlüssel für das Management-Board (wird am Ende einmalig ausgegeben; bei erneutem Lauf bleibt der vorhandene Schlüssel erhalten, QI_ROTATE_API_KEY=1 erzwingt Rotation)
6. Zufälliger Verschlüsselungsschlüssel für die Docker-Zugangsdaten (docker.encryption_key in /etc/quickinfo/config.php; bei Updates wird ein vorhandener Schlüssel wiederverwendet)

Danach: https://<server-ip> aufrufen, Zertifikatswarnung bestätigen, mit admin anmelden.

Umgebungsvariablen zur Anpassung: QI_DB_NAME, QI_DB_USER, QI_ADMIN_USER, QI_HTTP_PORT, QI_HTTPS_PORT, QI_CORS_ORIGINS (Komma-getrennt, Standard *), QI_ROTATE_API_KEY.

Projektstruktur

install.sh              Setup-Skript (idempotent, erneuter Lauf = Update + neues Admin-Passwort)
db.sql                  Datenbankschema
config.example.php      Beispielkonfiguration (→ /etc/quickinfo/config.php)
collector/collector.php Datenerfassung (PHP-CLI, systemd-Timer)
bin/apikey.php          API-Schlüssel per CLI verwalten (status | ensure | rotate | revoke)
bin/passwd.php          Passwort eines Benutzers per CLI zurücksetzen
src/bootstrap.php       Konfiguration, PDO, Hilfsfunktionen
src/auth.php            Session-Login, CSRF, Throttling
src/apikey.php          API-Schlüssel: Erzeugung, Hashing, Prüfung, Throttling, CORS
src/docker.php          Docker-Host-Modul: Verschlüsselung, SSH-Ausführung, Container/Volumes/Netzwerke/Logs/Notizen/Ordner
src/api.php             REST-Endpunkte (Web-Frontend, Session-basiert)
src/api_v1.php          Öffentliche Read-Only-API /api/v1/* (Bearer-Token)
public/index.html       Single-Page-Frontend
public/assets/          style.css · chart.js (Canvas-Graphen) · app.js
public/api/index.php    API-Einstiegspunkt (einzige PHP-Datei im Webroot)

REST-API

Methode	Pfad	Beschreibung
GET	/api/session	Login-Status + CSRF-Token + Systeminfo (Hostname, Kurzbeschreibung, Inventarnummer)
POST	/api/login	{username, password}
POST	/api/logout
GET	/api/overview	Aktueller Snapshot + Dienststatus
GET	/api/history?range=1h|3h|24h|3d|14d	Zeitreihen {metric: [[ts, value], …]}
GET/POST	/api/services	Dienste auflisten / hinzufügen
PUT/DELETE	/api/services/{id}	Anzeigename ändern / entfernen
GET	/api/services/available	systemd-Units auf dem System
POST	/api/password	{current, new}
POST	/api/system	{description, inventory} – Kurzbeschreibung / Inventarnummer speichern
GET	/api/apikey	Metadaten des API-Schlüssels, Pairing-Infos
POST	/api/apikey/rotate	Neuen API-Schlüssel erzeugen (Klartext einmalig in der Antwort)
DELETE	/api/apikey	API-Schlüssel widerrufen
GET	/api/docker/config	Öffentliche Docker-Konfiguration (ohne Secrets, mit has_password/has_private_key)
PUT	/api/docker/config	Docker-Einstellungen speichern; bei aktivem Host Verbindung prüfen (`status: ok
GET	/api/docker/status	Erreichbarkeit des Docker-Hosts prüfen ({ok: bool})
GET	/api/docker/containers	Alle Container ({containers: [{id, name, image, state, status, ports}]})
GET	/api/docker/containers/{name}	Detail inkl. Mounts, Netzwerke, Ports, Labels und Notiz
GET	/api/docker/containers/{name}/stats	Live-Auslastung (CPU, RAM, RAM %, Netz, Block-I/O, PIDs)
GET	/api/docker/containers/{name}/logs?lines=N	Letzte Log-Zeilen (max. 1000)
PUT	/api/docker/containers/{name}/note	{note} – Notiz zum Container speichern
PUT	/api/docker/containers/{name}/folder	{folder_id|null} – Container einem Ordner zuordnen bzw. freigeben
POST	/api/docker/containers/{name}/{start|stop|restart}	Container steuern
GET	/api/docker/volumes	Volumes auflisten
GET	/api/docker/networks	Netzwerke auflisten
GET/POST	/api/docker/folders	Ordner auflisten / anlegen {name}
PUT	/api/docker/folders/{id}	{name} – Ordner umbenennen
DELETE	/api/docker/folders/{id}	Ordner löschen (Container werden freigegeben)
PUT	/api/docker/folders/order	{ids: […]} – Ordner-Reihenfolge speichern
PUT	/api/docker/folders/{id}/containers	{containers: […]} – Inhalt/Reihenfolge eines Ordners speichern

Alle Endpunkte außer session und login erfordern eine Sitzung; schreibende Anfragen zusätzlich den Header X-CSRF-Token.

Schlägt eine Docker-Operation fehl (SSH nicht erreichbar, Docker-CLI-Fehler), antworten die /api/docker/*-Endpunkte mit 502 Bad Gateway und {"error": "Docker-Host nicht erreichbar: <Ursache>"}. Die Oberfläche zeigt diese Meldung im Statusfeld der Container-Ansicht an.

Management-Board-API (/api/v1)

Schreibgeschützte JSON-Schnittstelle, über die ein übergeordnetes Management-Board mehrere quickinfo-Instanzen einsammeln kann. Der API-Schlüssel wird im Admin-Panel unter Einstellungen → API & Management-Board erzeugt, eingesehen (Kennung, letzte Nutzung) und rotiert bzw. widerrufen. Alternativ per CLI: php /var/www/html/quickinfo/bin/apikey.php rotate.

Authentifizierung: Authorization: Bearer <API-KEY> (alternativ X-API-Key: <API-KEY>). Fehlende oder ungültige Schlüssel → 401 Unauthorized; nach 10 Fehlversuchen pro IP → 429 für 5 Minuten (konfigurierbar). Der Schlüssel wird ausschließlich als SHA-256-Hash in der Tabelle api_keys gespeichert.

Methode	Pfad	Beschreibung
GET	/api/v1/	Endpunktübersicht
GET	/api/v1/status	Aktuelle Messwerte: CPU (Auslastung, Kerne, Temperatur), GPU(s), RAM, Speicherplatz /, Load, Status aller Dienste
GET	/api/v1/history?range=1h|3h|24h|3d|14d[&metrics=cpu.total,temp.max]	Aggregierte Zeitreihen {metric: [[ts, value], …]}
GET	/api/v1/info	Hostname, Uptime, Systemzeit, OS/Kernel, CPU-Kerne & -Modell, GPU-Modell
GET	/api/v1/docker/containers	Container-Übersicht {containers: [{id, name, image, state, status, ports}, …]}
GET	/api/v1/docker/containers/{name}	Detail (Inspect): Image, Command, Status, Restart-Policy, Compose-Projekt/-Service, Ports, Mounts, Netzwerke, Labels, Notiz
GET	/api/v1/docker/containers/{name}/stats	Live-Auslastung (CPU, RAM, Netz, Block-I/O, PIDs)
POST	/api/v1/docker/containers/{name}/start|stop|restart	Container-Aktion; liefert {ok: true}

Die Docker-Endpunkte sind nur verfügbar, wenn unter Einstellungen → Docker-Host ein Host aktiviert und erreichbar ist. Andernfalls antworten sie mit 404 (Modul nicht aktiviert) bzw. 502 (Host nicht erreichbar). Die POST-Aktionen sind die einzige schreibende Ausnahme der sonst schreibgeschützten v1-API.

curl -k -H "Authorization: Bearer qi_…" https://<server-ip>/api/v1/status

CORS: Standardmäßig sind alle Origins erlaubt ('cors_origins' => ['*']), da der Zugriff ohnehin nur mit gültigem Schlüssel möglich ist. Für eine Einschränkung auf das Management-Board in /etc/quickinfo/config.php konkrete Origins hinterlegen, z. B. ['https://board.example.com']; [] deaktiviert CORS vollständig. Preflight-Anfragen (OPTIONS) werden ohne Authentifizierung mit 204 beantwortet.

Pairing: Im Management-Board die Server-URL (https://<ip>) und den API-Schlüssel hinterlegen. Nach einer Rotation wird der alte Schlüssel sofort ungültig und das Board muss mit dem neuen Schlüssel neu gekoppelt werden.

Docker-Host

Unter Einstellungen → Docker lässt sich der Host als Docker-Host markieren und die SSH-Verbindung hinterlegen:

• SSH-Host / -Port / -Benutzer des Docker-Hosts
• Authentifizierung: Passwort (benötigt sshpass) oder privater SSH-Key
• Verbindung testen prüft SSH und docker version auf dem entfernten Host

Die Zugangsdaten werden AES-256-GCM-verschlüsselt (Tabelle docker_host, Spalten password_enc / private_key_enc) gespeichert. Der Schlüssel wird aus docker.encryption_key in /etc/quickinfo/config.php abgeleitet (SHA-256 → 32 Byte); install.sh erzeugt ihn automatisch. Ist der Schlüssel leer, greift eine deterministische Fallback-Ableitung aus dem Installationspfad, damit vorhandene Daten lesbar bleiben. Leer gelassene Passwort-/Key-Felder im Formular bedeuten „bestehenden Wert beibehalten“.

Ist der Host aktiviert, wird die Hauptseite in zwei Tabs geteilt:

• Info – die bisherigen Kennzahlen, Verlaufsgraphen und Dienste
• Container – Liste aller Container; beim Auswählen: Start/Stop/Restart, Live-Auslastung (CPU, RAM, Netz, Block-I/O, PIDs), Mounts/Volumes, Netzwerke, Port-Weiterleitungen, letzte Log-Einträge (wählbare Zeilenzahl) und eine frei editierbare Notiz je Container
• Ordner – Container lassen sich logisch gruppieren: Über das Eingabefeld oberhalb der Liste werden benannte Ordner angelegt. Container werden per Drag & Drop in Ordner verschoben (oder über „Ohne Ordner“ wieder herausgenommen), innerhalb eines Ordners sortiert und die Ordner selbst per Drag & Drop umsortiert. Umbenennen per Doppelklick, Löschen über das ×-Symbol (Container bleiben erhalten).

Alle Docker-Kommandos werden remote per SSH auf dem Ziel-Host ausgeführt (ssh … docker …). Das lokale docker-CLI wird nicht verwendet. Container-Notizen werden lokal in der Tabelle docker_container_notes (Schlüssel: Container-Name) gespeichert. Ordner und Zuordnungen liegen in docker_folders bzw. docker_container_folders.

Datenhaltung

• metrics: Rohdaten in Minutenauflösung, Retention 4 Tage
• metrics_agg: 10-Minuten-Buckets (avg/min/max), Retention 30 Tage
• service_log: Dienststatus pro Minute, Retention 30 Tage
• docker_host: Singleton-Zeile (id = 1) mit Aktivierung und verschlüsselten SSH-Zugangsdaten
• docker_container_notes: Container-Notizen (Primärschlüssel: Container-Name)
• docker_folders: benannte Ordner mit sort_order (Reihenfolge)
• docker_container_folders: Zuordnung Container → Ordner (Primärschlüssel: Container-Name, folder_id nullable) inkl. sort_order für die Position innerhalb des Ordners

Die Wartung läuft automatisch einmal pro Stunde im Collector. Manuell:

sudo php /var/www/html/quickinfo/collector/collector.php --verbose --maintenance

Betrieb

systemctl status quickinfo-collector.timer
journalctl -u quickinfo-collector.service -n 50
tail -f /var/log/nginx/quickinfo.error.log
php /var/www/html/quickinfo/bin/apikey.php status   # API-Schlüssel prüfen

Seite bleibt leer / kein Login-Formular

Bleibt die Seite in einem Browser (typisch: Safari) leer, liegt das fast immer an blockierten Website-Daten oder an veralteten Assets aus dem Cache:

• Safari blockiert Website-Daten („Website-Daten blockieren“, „Cross-Site-Tracking verhindern“) → localStorage ist gesperrt. Die App startet trotzdem und zeigt das Login-Formular; ein Hinweis erscheint nur, wenn das Skript gar nicht laden konnte.
• Früher lagen Assets sieben Tage im Browser-Cache, index.html wurde heuristisch gecacht. Nach einem Update konnte ein Browser dadurch mit veralteten Dateien laufen. Nginx liefert beides jetzt mit expires -1 (Revalidierung per ETag) aus – dafür install.sh erneut ausführen. Bis dahin hilft ein Hard-Reload.

Vergessenes Admin-Passwort zurücksetzen

Das Passwort lässt sich direkt auf dem Server per CLI neu setzen (kein MySQL-Wissen nötig):

# Benutzer "admin": neues Passwort verdeckt eingeben (mind. 10 Zeichen, wird zweimal abgefragt)
sudo php /var/www/html/quickinfo/bin/passwd.php

# Anderer Benutzername
sudo php /var/www/html/quickinfo/bin/passwd.php <benutzer>

# Zufälliges Passwort erzeugen und einmalig ausgeben
sudo php /var/www/html/quickinfo/bin/passwd.php --random

# Nicht-interaktiv, z. B. aus einem Skript
printf '%s\n' 'neuesPasswort' | sudo php /var/www/html/quickinfo/bin/passwd.php admin

Der Befehl schreibt einen neuen password_hash()-Hash in die Tabelle users und hebt bestehende Login-Sperren (login_attempts) auf. PHP-FPM/Nginx müssen nicht neu gestartet werden; bereits angemeldete Sitzungen bleiben bis zum Ablauf gültig.

Ohne das Skript geht es auch direkt über MySQL:

NEW_HASH="$(sudo php -r 'echo password_hash($argv[1], PASSWORD_DEFAULT);' 'neuesPasswort')"
sudo mysql quickinfo -e "UPDATE users SET password_hash='${NEW_HASH}' WHERE username='admin';"