Fehlerbehebung
Häufige Fehler anhand der Symptome beheben.
Die Oberfläche startet nicht
Prüfen Sie docker compose ps und vollständige Startlogs. Prüfen Sie Ports und Datenzugriff für die tatsächliche UID:GID. Bei Erstinstallation ist kein explizites Umgebungsgeheimnis nötig. Ein Neubau korrigiert keine Host-ACLs.
Eine Integration funktioniert im Browser, aber nicht in NasDash
Testen Sie die Verbindung aus dem Container heraus. Ersetzen Sie localhost durch den Compose-Dienstnamen, eine private IP-Adresse oder einen routbaren DNS-Namen. Prüfen Sie die Firewall- und Routing-Einstellungen.
Docker meldet einen 403-Fehler oder eine Aktion schlägt fehl
Prüfen Sie zuerst den Verbindungstyp. Kontrollieren Sie bei Portainer oder Dockhand API-Schlüssel und Umgebungsrechte. Prüfen Sie bei HTTP-API oder Socket-Proxy erlaubte Routen und Methoden wie CONTAINERS, POST und DELETE. Prüfen Sie bei Unix-Sockets den eingebundenen Pfad und den Zugriff des Laufzeitbenutzers. Aktivieren Sie keine sachfremden Funktionen.
Glances gibt HTML zurück
NasDash erwartet JSON auf der Route /api/<version>/all. Stellen Sie sicher, dass der Glances-Webserver und nicht eine Proxy-Authentifizierungsseite antwortet.
Proxmox meldet 401/403
Prüfen Sie die vollständige Token-ID, das Secret, den exakten Knotennamen und die Leseberechtigung auf dem korrekten Pfad. Rotieren Sie ein kompromittiertes Secret, anstatt es in Protokollen zu kopieren.
CSS macht die Oberfläche unbrauchbar
Fügen Sie ?safe-css=1 zur URL hinzu, öffnen Sie die Entwickler-Einstellungen, beheben oder löschen Sie das CSS und laden Sie die Seite anschließend ohne den Parameter neu. Siehe Custom CSS.
Betrachter sehen zu viel oder zu wenig
Prüfen Sie geheime Kategorien und Tab-/Widget-Listen. Leere Listen bedeuten uneingeschränkten Zugriff innerhalb der Liste. Rechteänderungen widerrufen Sitzungen: Melden Sie sich neu an. Siehe Zugriffsmatrix.
Synology und Berechtigungen des Datenordners
Images ab Version 0.2.2 prüfen den Zugriff vor dem Start und melden die tatsächliche UID:GID bei unzugänglichen Daten, Logos oder bestehenden Dateien. Korrigieren Sie die Berechtigungen und erstellen Sie den Container neu. UID/GID-Tests unter Docker Linux ersetzen keine Prüfung auf einem echten DSM.
Synology und Berechtigungen des Datenordners
Fehlender Einrichtungscode oder verlorener Zugang
Der Einrichtungscode erscheint einmalig, nachdem der Hash des Administratorpassworts gespeichert wurde und bevor der Server bereit ist. Prüfen Sie die vollständigen Startprotokolle einschließlich Warnungen/stderr. Neustart oder Neubau gibt keinen neuen Code aus. War NASDASH_ADMIN_PASSWORD bei der Kontoerstellung gesetzt, verwenden Sie dieses erste Passwort.
Bei verlorenem Code oder Passwort zeigt Vergessen? auf dem regulären Anmeldebildschirm den Befehl zur Offline-Wiederherstellung. Sichern Sie die Daten und stoppen Sie NasDash vor der Ausführung; behalten Sie Daten-Mount und UID/GID bei. Siehe Einrichtungscode und Offline-Wiederherstellung.
Monitoring-Fehler und Zertifikate
Timeouts, abgelehnte Verbindungen und unerreichbare Hosts sind wiederholbare Warnungen. Anmeldung 401/403, fehlender Endpunkt 404 und ungültiges JSON sind Konfigurationsfehler. Erlauben Sie selbstsignierte Zertifikate ausdrücklich nur für die gewählte Verbindung; deaktivieren Sie TLS niemals global. Siehe Glances-Diagnose und Proxmox-Einstellungen.
Nennen Sie Integrationstyp, Version/Digest, bereinigte URL, Fehlercode, Häufigkeit und relevante Dienstlogs. Entfernen Sie Einrichtungscodes, Startpasswörter, Tokens, Cookies, Schlüssel und private Daten vor dem Issue-Dialog. Veröffentlichen Sie kein Datenverzeichnis.
Bei beschädigter gespeicherter Konfiguration bewahrt NasDash die Datei auf und stellt privaten Zugriff wieder her; die Wiederherstellung veröffentlicht die Instanz nicht. Stoppen Sie den Dienst, behalten Sie die beschädigte Kopie und stellen Sie eine geprüfte vollständige Sicherung wieder her oder reparieren die Konfiguration. Aktualisierungen bereiten zusammengehörige Dateien gemeinsam vor und rollen gemeldete Schreibfehler zurück; dies garantiert keine Ausfallsicherheit bei Stromverlust. Bewahren Sie Sicherungen auf getrenntem Speicher auf.