Skip to main content

19_Navidrome

navidrome-navidrome-1

🎧 Your Personal Streaming Service

Image deluan/navidrome:latest Version 0.61.2 Etat Up Compose project navidrome Reseau navidrome_default URL https://navidrome.juxjux.ovh Source https://github.com/navidrome/navidrome

Ports

Hote Container IP 4533 4533/tcp 0.0.0.0

Volumes

Source (hote) Destination Type Mode /home/debian/music /music bind rw, :shared /home/debian/docker/navidrome/data /data bind rw

Integration Claude Code — MCP

Statut MCP MCP actif Outils (prefix) mcp__navidrome__ Configuration Script Python : C:\Users\eliob\.claude\mcp_navidrome.py | Auth : Subsonic API avec hachage MD5 (user + token + sel)

Outils disponibles

    ping get_artists get_artist get_albums get_album get_song get_genres get_random_songs get_playlists get_playlist create_playlist get_starred star unstar search get_now_playing

    Ce que nous pouvons faire ensemble

      Parcourir artistes, albums et pistes de la médiathèque musicale Rechercher un titre, artiste ou album Voir ce qui est en cours de lecture (now playing) Gérer les playlists (création, lecture) Étoiler/désigner des favoris Générer une sélection aléatoire par genre

      Scans automatiques

      Trois mécanismes automatiques assurent la fraîcheur de la bibliothèque :

      Cron Script Type Rôle */5 * * * * /home/debian/monitor-rclone.sh Watchdog Détecte FUSE mort → restart service + restart container (recovery auto) 30 4 * * * /home/debian/navidrome_scan.sh Quick scan vfs/refresh + scan quotidien (MAJ des titres existants) 0 3 * * 1 /home/debian/navidrome_fullscan.sh Full scan vfs/refresh + restart container → full scan hebdomadaire (détecte nouveaux albums/artistes)

      Log commun : /var/log/navidrome_scan.log

      Quick scan vs Full scan

      Le quick scan (startScan via API Subsonic) ne traverse que les dossiers déjà connus de Navidrome — il ne détecte pas les nouveaux artistes ou albums ajoutés sur kDrive. Seul un full scan indexe les nouveaux dossiers.

      Le full scan est déclenché automatiquement au démarrage du container. C'est pourquoi navidrome_fullscan.sh fait un restart container plutôt qu'un simple appel API.

      Auth RC sur kdrive-music.service

      Depuis rclone 1.74.3, vfs/refresh exige une authentification RC. Le service kdrive-music.service a été mis à jour le 2026-06-24 avec --rc-user=rcadmin --rc-pass=RcMusic2026!.

      Commande de refresh manuel :

      rclone rc --rc-addr 127.0.0.1:5576 --rc-user=rcadmin --rc-pass=RcMusic2026! vfs/refresh recursive=true

      Recovery automatique FUSE — monitor-rclone.sh (2026-06-24)

      Le script /home/debian/monitor-rclone.sh (cron */5 * * * *) surveille les 5 mounts rclone et effectue une recovery complète si l'un d'eux est mort.

      Fonctionnement

      Pour chaque mount (/music, /komga, /livres, /audiobookshelf/audiobooks, /photo) :

        timeout 10 ls <mount> — si inaccessible : sudo systemctl restart <service> (kdrive-music, kdrive-komga, kdrive-livres, rclone-audiobooks, rclone-photo) Attente 5s + vérification que le mount répond Restart des containers Docker associés :
          /music → navidrome-navidrome-1 /komga → komga /livres → Kavita /audiobookshelf/audiobooks → audiobookshelf /photo → Immich-SERVER Immich-MICROSERVICES

          Le script est silencieux quand tout va bien — il ne logue que les pannes et recoveries. Log : /home/debian/logs/rclone-monitor.log

          Avant cette refactorisation, le script lançait un rclone mount direct (en parallèle des services systemd) et ne redémarrait pas les containers — le FUSE était remonté mais Navidrome gardait l'ancienne référence corrompue.

          REX — 2026-06-24 : FUSE mort récurrent

          Contexte

          Le FUSE /music est mort en cours de journée. Symptôme Navidrome : stat /music: transport endpoint is not connected lors du scan.

          Cause

          Le service kdrive-music.service peut rester active (running) avec un FUSE mort — le process rclone est vivant mais la connexion noyau FUSE est cassée. Systemd ne détecte pas ce cas et ne redémarre pas le service.

          Solution mise en place

          Refactorisation de monitor-rclone.sh pour utiliser systemctl restart (au lieu d'un rclone mount direct) et redémarrer les containers Docker après remontage. Le watchdog tourne toutes les 5 minutes — la panne est détectée et corrigée automatiquement sans intervention.

          Procédure manuelle si besoin

          sudo systemctl restart kdrive-music.service
ls /home/debian/music | head -5
sudo docker restart navidrome-navidrome-1

          Puis force-fermer Symfonium et relancer — le token de session Navidrome est invalidé après le restart du container.

          REX — 2026-06-24 : nouveaux albums non détectés

          Contexte

          Les Négresses Vertes (et d'autres albums récemment ajoutés sur kDrive) n'apparaissaient pas dans Navidrome malgré le cron quotidien.

          Cause

          Double problème :

          1. Cache VFS 72h : --dir-cache-time 72h sur kdrive-music.service — les nouveaux dossiers kDrive ne sont pas visibles dans le mount avant expiration ou vfs/refresh.
          2. Quick scan insuffisant : le scan quotidien (startScan API) est un quick scan qui ne traverse que les dossiers déjà connus. Il ne détecte pas de nouveaux artistes.

          Solution immédiate

          rclone rc --rc-addr 127.0.0.1:5576 --rc-user=rcadmin --rc-pass=RcMusic2026! vfs/refresh recursive=true
sudo docker restart navidrome-navidrome-1

          Le restart container déclenche un full scan au démarrage (~20 min pour 16 000 titres). Vérifier avec getScanStatus ("scanning":false = terminé).

          Solution pérenne

          Full scan hebdomadaire chaque lundi à 3h UTC (navidrome_fullscan.sh) — garantit que tout nouvel album ajouté dans la semaine est indexé au plus tard le lundi matin.

          REX — 2026-06-13 : FUSE corrompu / Symfonium inaccessible

          Contexte

          Après l'incident sécurité rclone du 2026-06-09 (CVE-2026-41179), le service kdrive-music.service a été relancé. Il est resté actif 4 jours sans crash apparent, mais le mount FUSE /home/debian/music était silencieusement corrompu.

          SymptĂ´mes

          • Symfonium (Subsonic) : erreur "trop d'erreurs, arrĂŞt de lecture" sur tous les appareils portables
          • Logs Navidrome : transport endpoint is not connected sur tous les fichiers audio
          • systemctl status kdrive-music.service : active (running) depuis 3 jours — aucune indication du problème

          Cause

          Le process rclone Ă©tait vivant mais la connexion noyau FUSE Ă©tait morte. Pas de crash = pas de restart automatique par systemd.

          Procédure de résolution

          1. Redémarrer le service rclone : sudo systemctl restart kdrive-music.service
          2. Vérifier que le mount répond : ls /home/debian/music | head -5
          3. Redémarrer le container Navidrome — nécessaire même avec :shared, car le container garde l'ancienne référence FUSE corrompue
          4. Sur les appareils : force-fermer Symfonium et relancer

          Notes

          • La propagation :shared ne suffit pas Ă  propager un nouveau mount FUSE Ă  un container dĂ©jĂ  dĂ©marrĂ© — le container doit ĂŞtre redĂ©marrĂ©.
          • Attention spool /tmp : un restart du service rclone peut crĂ©er un fichier /tmp/rclone-spool* de plusieurs Go si des fichiers cachĂ©s sont marquĂ©s "dirty". PrĂ©fĂ©rer vfs/refresh (avec auth RC) au restart quand le FUSE n'est pas corrompu.
          Back to top