Exploitation

Dépannage

Résoudre les erreurs fréquentes par symptôme.

L'interface ne démarre pas

Vérifiez docker compose ps et les journaux complets du démarrage. Vérifiez les ports et l’accès aux données pour l’UID:GID réel. Aucun secret d’environnement explicite n’est requis à la première installation. Reconstruire l’image ne corrige pas les ACL du dossier hôte.

Une intégration marche depuis le navigateur, pas dans NasDash

Testez depuis le conteneur. Remplacez localhost par le nom du service Compose, une IP privée ou un nom DNS routable. Vérifiez pare-feu et routage.

Docker affiche 403 ou une action échoue

Vérifiez d’abord le type de connexion. Pour Portainer ou Dockhand, contrôlez la clé API et ses permissions sur l’environnement. Pour une API HTTP ou un proxy de socket, vérifiez les routes et méthodes autorisées, notamment CONTAINERS, POST et DELETE. Pour un socket Unix, vérifiez le chemin monté et l’accès de l’utilisateur d’exécution. N’activez pas de capacités sans rapport.

Glances renvoie HTML

NasDash attend du JSON sur une route /api/<version>/all. Vérifiez que le serveur Web Glances, et non une page d'authentification de proxy, répond.

Proxmox affiche 401/403

Vérifiez le Token ID complet, le secret, le nom exact du nœud et le rôle de lecture sur le bon chemin. Renouvelez un secret compromis au lieu de le recopier dans des logs.

Le CSS rend l'interface inutilisable

Ajoutez ?safe-css=1 à l'URL, ouvrez les réglages développeur, corrigez ou effacez le CSS, puis rechargez sans le paramètre. Voir CSS personnalisé.

Les lecteurs voient trop ou trop peu

Vérifiez la visibilité des catégories secrètes et les listes d’onglets/widgets du lecteur. Une liste vide signifie un accès illimité dans cette liste. Les changements révoquent les sessions : reconnectez-vous. Consultez la matrice d’accès serveur.

Synology et permissions du dossier de données

Les images à partir de la version 0.2.2 vérifient les accès avant le démarrage et indiquent l’UID:GID réel si les données, les logos ou les fichiers existants sont inaccessibles. Corrigez les permissions du dossier, puis recréez le conteneur. Les tests UID/GID sous Docker Linux ne remplacent pas une validation sur un vrai DSM.

Synology et permissions du dossier de données

Code de configuration absent ou accès perdu

Le code de configuration apparaît une seule fois, après l’enregistrement de l’empreinte du mot de passe administrateur et avant que le serveur soit prêt. Consultez tous les journaux du démarrage, y compris les avertissements/stderr. Redémarrer ou reconstruire ne produit pas de nouveau code. Si NASDASH_ADMIN_PASSWORD était défini à la création du compte, utilisez plutôt ce premier mot de passe.

En cas de code ou de mot de passe perdu, Oublié ? sur l’écran de connexion habituel affiche la commande de récupération hors ligne. Sauvegardez les données et arrêtez NasDash avant de l’exécuter ; conservez le même montage et le même UID/GID. Voir code de configuration et récupération hors ligne.

Erreurs de monitoring et certificats

Délais dépassés, connexions refusées et hôtes injoignables sont des avertissements avec nouvelle tentative. Les erreurs d’authentification 401/403, d’endpoint 404 et de JSON malformé relèvent de la configuration. Pour un certificat autosigné, activez son acceptation uniquement sur la connexion choisie ; ne désactivez jamais TLS globalement. Consultez le diagnostic Glances et les réglages Proxmox.

Pour un retour, indiquez type d’intégration, version/digest, URL expurgée, code d’erreur, fréquence et journaux pertinents du service distant. Retirez les codes de configuration, mots de passe de démarrage, jetons, cookies, clés et données privées avant d’utiliser les tickets. Ne publiez pas le dossier de données.

Si la configuration enregistrée est endommagée, NasDash conserve le fichier et récupère en accès privé ; la récupération ne publie pas l’instance. Arrêtez le service, conservez la copie endommagée et restaurez une sauvegarde complète vérifiée ou réparez la configuration. Les mises à jour préparent les fichiers liés ensemble et annulent les échecs d’écriture signalés ; cela ne garantit pas la résistance aux coupures de courant. Gardez des sauvegardes sur un stockage distinct.