{ "meta": { "title": "ProxMenux Monitor | ProxMenux-Dokumentation", "description": "Aktivieren oder deaktivieren Sie die proxmenux-monitor.service systemd-Einheit und überprüfen Sie ihren aktuellen Zustand. Der Monitor stellt eine Web-Benutzeroberfläche auf TCP 8008 für die visuelle Host-Überwachung zur Verfügung.", "ogTitle": "ProxMenux Monitor | ProxMenux-Dokumentation", "ogDescription": "Aktivieren oder deaktivieren Sie den systemd-Dienst proxmenux-monitor und prüfen Sie seinen Status in den Einstellungen." }, "header": { "title": "ProxMenux Monitor", "description": "Zwei zusammenhängende Aktionen innerhalb des Einstellungsmenüs: Umschalten der proxmenux-monitor.service systemd-Einheit (Start / Stopp und Aktivieren / Deaktivieren mit einem Klick) und Anzeigen des aktuellen Detailstatus. Der Monitor stellt eine Web-Benutzeroberfläche auf TCP 8008 für die visuelle Host-Überwachung zur Verfügung.", "section": "Einstellungen" }, "intro": { "title": "Was ist ProxMenux Monitor?", "body": "ProxMenux Monitor ist ein integriertes Web-Dashboard, das Echtzeit-Sichtbarkeit in Ihre Proxmox-Infrastruktur bietet - zugänglich von jedem Browser in Ihrem Netzwerk, ohne ein Terminal zu benötigen." }, "offers": { "heading": "Was es bietet", "items": [ "Echtzeitüberwachung von CPU, RAM, Festplattennutzung und Netzwerkverkehr.", "Überblick über laufende VMs und LXC Container mit Statusindikatoren.", "Login-Authentifizierung zum Schutz des Zugriffs.", "Zwei-Faktor-Authentifizierung (2FA) mit TOTP-Unterstützung.", "Reverse Proxy Unterstützung (Nginx / Traefik).", "Entwickelt für die Arbeit auf Desktop- und mobilen Geräten." ] }, "access": { "heading": "Zugang", "intro": "Nach der Installation ist das Dashboard verfügbar unter:", "url": "http://:8008", "outro": "Der Monitor wird automatisch als Teil der Standard-ProxMenux-Installation installiert und läuft als systemd-Dienst (proxmenux-monitor.service), der beim Booten automatisch startet." }, "warnConditional": { "title": "Einstellungen Optionen nur sichtbar, wenn Monitor installiert ist", "body": "Die beiden unten beschriebenen Menüeinträge erscheinen nur in den Einstellungen, wenn proxmenux-monitor.service bei systemd registriert ist. Wenn Sie sie nicht sehen, wurde der Monitor nicht installiert (er ist während der ProxMenux-Installation optional). Um es später hinzuzufügen, installieren Sie ProxMenux mit der neuesten Version neu und wählen Sie die Option Monitor aus." }, "toggle": { "heading": "Aktivieren/Deaktivieren", "intro": "Der erste Menüeintrag ist ein einzelner Umschalter, der zwischen zwei Zuständen wechselt, je nachdem, ob der Dienst gerade ausgeführt wird:", "headerState": "Aktueller Zustand", "headerLabel": "Menü-Label abgebildet", "headerAction": "Aktion nach Bestätigung", "rows": [ { "state": "aktiv", "label": "Deaktivieren Sie den ProxMenux Monitor", "action": "systemctl stop + disable" }, { "state": "inaktiv", "label": "Aktivieren Sie den ProxMenux Monitor", "action": "systemctl enable + start" } ], "outro": "Jede Umschaltung erfordert einen Ja/Nein-Dialog. Deaktivieren stoppt den Dienst und deaktiviert den Autostart; Aktivieren schaltet den Autostart ein und startet den Dienst sofort." }, "status": { "heading": "Status des Überwachungsdienstes anzeigen", "intro": "Der zweite Menüeintrag liest nur Informationen. Er leert den Bildschirm, zeigt das ProxMenux-Logo und den Titel „Überprüfung des Dienstes ProxMenux Monitor“ und meldet dann :", "items": [ "Servicestatus: aktiv, inaktiv oder not_installed.", "Web UI URL (nur wenn aktiv): http://<host_ip>:8008 — abgeleitet von hostname -I | awk '''{print $1}'''.", "Detaillierter systemd-Ausgang: systemctl status proxmenux-monitor.service --no-pager -l — zeigt aktuelle Protokollzeilen, ExecStart, MainPID usw." ] }, "manual": { "title": "Manuelle Äquivalente", "intro": "Von jeder Shell:", "code": "systemctl status proxmenux-monitor.service # detailed status\nsystemctl is-active proxmenux-monitor.service # one-word status\nsystemctl enable --now proxmenux-monitor.service # enable + start\nsystemctl disable --now proxmenux-monitor.service # stop + disable\njournalctl -u proxmenux-monitor.service -f # follow live logs" }, "reset": { "heading": "ProxMenux Monitor Passwort zurücksetzen", "intro": "Wiederherstellungspfad für den Betreiber, der das Dashboard-Passwort (oder 2FA-Gerät) verloren hat. Die Option wird nur angezeigt, wenn der Monitor auf dem Host installiert ist. Auswählen:", "items": [ "Bittet um Bestätigung mit einem Ja / Nein-Dialog - die Aktion ist destruktiv für die Anmeldeinformationen.", "Sichert den vorhandenen /root/.config/proxmenux-monitor/auth.json auf auth.json.bak-<UTC timestamp> (Modus 0600), so dass der vorherige Zustand manuell wiederhergestellt werden kann, wenn das Zurücksetzen ein Fehler war.", "Stoppt den Dienst proxmenux-monitor, damit die Dateibearbeitung nicht gleichzeitig mit einer laufenden Anmeldung erfolgt.", "Löscht die Identitätsfelder in auth.json: enabled=false, configured=false, leert username, password_hash, totp_secret und das Backup-Code-Array.", "Behält jwt_secret sowie die registrierten api_tokens / revoked_tokens bei, sodass langlebige API-Token von Home Assistant oder anderen Skripten nach dem Zurücksetzen weiterhin zur Authentifizierung funktionieren.", "Startet den Dienst neu. Der nächste Besuch bei http://<host>:8008 zeigt den Erststart-Setup-Assistenten, sodass ein neues Admin-Konto erstellt werden kann." ], "preservedTitle": "Was überlebt den Reset, was nicht", "preservedBody": "Gelöscht: Benutzername, Passwort-Hash, TOTP-Geheimnis für 2FA und Wiederherstellungscodes. Beibehalten: jwt_secret, Metadaten von api_tokens und die Liste revoked_tokens. Um auch alle API-Token ungültig zu machen und vollständig neu zu beginnen, löschen Sie auth.json manuell statt dieser Menüoption. Beim nächsten Dienststart werden JWT-Geheimnis und alle weiteren Daten neu erzeugt.", "trustTitle": "Physical-Host-Zugang ist der Trust-Anker", "trustBody": "Dieser Reset-Pfad erfordert eine Root-Shell auf dem Host. Jeder, der den menu-Befehl als root ausführen kann, steuert bereits die Box, so dass die Passwortwiederherstellung keine Privilegeskalation ist - sie stimmt mit der Funktionsweise jedes anderen Admin-Tools auf Proxmox überein. Die logische Folge: Der Monitor-Login schützt nichts vor jemandem, den Sie bereits in die Proxmox-Shell eingelassen haben.", "seeAlso": "Siehe auch Monitor → Zugriff und Authentifizierung → Verlorenes Passwort wiederherstellen für denselben Ablauf aus Sicht des Dashboards sowie die Hintergründe zu Passwort-Hashes und zur Erzeugung des JWT-Geheimnisses." }, "files": { "heading": "Beteiligte Dateien", "code": "/etc/systemd/system/proxmenux-monitor.service # systemd unit\n/root/.config/proxmenux-monitor/ # runtime config dir\n/var/log/proxmenux-auth.log # Flask app auth log\n # (read by Fail2Ban [proxmenux] jail)" }, "troubleshoot": { "heading": "Fehlerbehebung", "missingTitle": "Beide Menüoptionen fehlen", "missingBody": "Der Monitor ist nicht bei systemd registriert. Bestätigen Sie mit systemctl list-unit-files | grep proxmenux-monitor - wenn keine Ausgabe vorhanden ist, installieren Sie ProxMenux mit der neuesten Version erneut vom offiziellen Installer und wählen Sie während der Installation die Option Monitor aus.", "unreachableTitle": "Service aktiviert, aber die URL ist nicht erreichbar", "unreachableBody": "Die Einstellungsstatusausgabe gibt Ihnen die IP. Bestätigung:", "unreachableCmd": "ss -tlnp | grep 8008 # is anything listening?\njournalctl -u proxmenux-monitor -n 100 --no-pager # recent errors\ncurl -sI http://localhost:8008 # local reachability", "unreachableOutro": "Wenn localhost funktioniert, aber nicht extern, überprüfen Sie Ihre Host-Firewall (pve-firewall oder nftables) auf eingehende TCP 8008.", "stopsTitle": "Aktiviert den Dienst, aber es stoppt sich ein paar Sekunden später", "stopsBody": "Meist liegt ein Portkonflikt (ein anderer Prozess nutzt 8008) oder eine fehlgeschlagene Abhängigkeitsprüfung vor. Das Systemjournal zeigt die Ursache: journalctl -u proxmenux-monitor.service -b." }, "related": { "heading": "Verwandte Themen", "items": [ { "href": "/docs/security/fail2ban", "label": "Fail2Ban", "tailRich": "– der [proxmenux] jail schützt den Monitor auf TCP 8008." }, { "href": "/docs/settings", "label": "Einstellungen Übersicht", "tail": "." } ] } }