Configuration de production
Checklist avant d'guide NasDash comme tableau de bord quotidien.
Checklist minimale
- Les clés persistantes et tout
NASDASH_JWT_SECRETexistant restent inchangés. - Le mot de passe administrateur et ceux des éventuels comptes lecteurs utilisés pour se connecter sont uniques.
- Le mode privé protège les informations sensibles.
- Le port
2504est limité au LAN/VPN ou à un proxy local. - HTTPS et l’en-tête
X-Forwarded-Proto: httpsdu proxy sont configurés pour les réseaux non fiables. - Si un proxy de socket est choisi, gardez-le privé avec
DELETE=0sauf besoin ; limitez les droits Portainer/Dockhand à l’environnement nécessaire. - Une sauvegarde complète de
/app/dataet sa restauration sont testées. - Le tag/digest précédent est conservé pour revenir en arrière.
- Les journaux et
/api/healthsont vérifiés après mise à jour.
Réduire l'exposition du port
Reverse proxy sur la même machine :
ports:
- "127.0.0.1:2504:2504"Reverse proxy dans le même réseau Docker : retirez complètement ports du service NasDash et utilisez expose: ["2504"]. Le proxy doit alors joindre nasdash:2504 par le réseau interne.
Mode public ou privé
Les installations neuves sont privées. Activer le mode public crée viewer s’il manque ; il peut initialement lire toutes les pages et tous les widgets. Les visiteurs anonymes utilisent ses permissions : vérifiez-les dans Paramètres → Utilisateurs et accès avant d’ouvrir l’accès.
Le mode public n'accorde pas les mutations à un visiteur, mais il peut exposer les services et widgets autorisés au viewer. Il ne remplace pas une décision de publication. Pour un homelab personnel, le mode privé derrière Tailscale ou HTTPS est le point de départ le plus prudent.
Une seule instance
NasDash stocke ses données dans des fichiers JSON et utilise des caches en mémoire. Ne lancez pas plusieurs réplicas qui écrivent dans le même volume. Un déploiement serverless ou multi-instance n'est pas le modèle de production auto-hébergé pris en charge.
Pour les limites de requêtes, les adresses transmises par les en-têtes de proxy sont ignorées par défaut. Activez NASDASH_TRUST_PROXY=true seulement derrière un proxy de confiance qui remplace les en-têtes fournis par le client et interdit l’accès direct à NasDash. Sinon gardez NASDASH_TRUST_PROXY=false. Ce réglage change uniquement l’identité des quotas ; il ne modifie ni la détection HTTPS ni les cookies d’authentification. Les échecs de connexion sont aussi limités par compte, indépendamment des en-têtes.