Risoluzione dei problemi

L'interfaccia non si avvia

Controllate docker compose ps e log completi di avvio. Verificate porte e accesso ai dati per l’UID:GID reale. Una nuova installazione non richiede un segreto d’ambiente esplicito. Ricostruire non corregge ACL dell’host.

Un'integrazione funziona nel browser ma non in NasDash

Esegui un test dal container. Sostituisci localhost con il nome del servizio Compose, un IP privato o un nome DNS instradabile. Controlla il firewall e il routing.

Docker mostra 403 o un'azione non riesce

È probabile che il proxy stia bloccando la rotta. Controlla CONTAINERS, POST, DELETE e gli altri permessi. Non abilitare a livello globale funzionalità non necessarie.

Glances restituisce HTML

NasDash prevede JSON sulla rotta /api/<version>/all. Verifica che a rispondere sia il server web di Glances e non una pagina di autenticazione del proxy.

Proxmox mostra 401/403

Controlla il Token ID completo, il segreto, il nome esatto del nodo e il ruolo di lettura sul percorso corretto. Ruota un segreto compromesso invece di copiarlo nei log.

Il CSS rende l'interfaccia inutilizzabile

Aggiungi ?safe-css=1 all'URL, apri le impostazioni sviluppatore, correggi o cancella il CSS, quindi ricarica senza il parametro. Vedi CSS personalizzato.

I visualizzatori vedono troppo o troppo poco

Controllate categorie segrete ed elenchi schede/widget. Elenchi vuoti significano accesso illimitato in quell’elenco. Cambiare permessi revoca sessioni: accedete di nuovo. Consultate la matrice d’accesso.

Synology e permessi della cartella dei dati

Le immagini dalla versione 0.2.2 in poi verificano l’accesso prima dell’avvio e indicano l’UID:GID effettivo se dati, loghi o file esistenti sono inaccessibili. Correggete i permessi e ricreate il contenitore. I test UID/GID su Docker Linux non sostituiscono una verifica su un DSM reale.

Synology e permessi della cartella dei dati

Password iniziale assente o accesso perso

Le immagini dalla versione 0.2.2 in poi inizializzano i nuovi account prima che il server sia pronto. Le password generate vengono mostrate una sola volta dopo aver salvato i loro hash. Consultate tutti i log di avvio, inclusi avvisi/stderr, invece delle sole ultime 100 righe. In 0.2.1, l’inizializzazione viene attivata dal primo tentativo di accesso; aprite la pagina di accesso e inviate una richiesta prima di controllare i log.

Password iniziale assente o accesso perso

Errori di monitoraggio e certificati

Timeout, connessioni rifiutate e host irraggiungibili sono avvisi con nuovi tentativi. Autenticazione 401/403, endpoint 404 e JSON malformato sono errori di configurazione. Accettate certificati autofirmati esplicitamente solo nella connessione scelta; non disattivate TLS globalmente. Consultate diagnosi Glances e impostazioni Proxmox.

Includete tipo di integrazione, versione/digest, URL oscurato, codice, frequenza e log del servizio remoto. Rimuovete password iniziali, token, cookie, chiavi e dati privati prima del selettore segnalazioni. Non pubblicate la cartella dati.