Aller au contenu

Gonic (serveur) & Feishin (client web)

Mise en place d'un serveur de streaming audio auto-hébergé léger : Gonic comme backend compatible Subsonic/OpenSubsonic, axé sur la navigation par dossiers, et Feishin comme interface web moderne pour explorer et écouter la bibliothèque depuis le navigateur.

Hôte quartidi — 192.168.1.104
Déploiement Docker Compose, /opt/dockers/gonic/
Ports Gonic 8001, Feishin 8002

🏗️ La stack

  • Gonic (8001 sur l'hôte) : serveur audio écrit en Go. Il indexe les fichiers musicaux en respectant l'arborescence des répertoires et expose une API compatible Subsonic/OpenSubsonic.
  • Feishin (8002 sur l'hôte) : interface web dans l'esprit de Spotify. Elle explore la bibliothèque, lit la musique dans le navigateur et propose la vue par dossiers.

Pourquoi ce couple

Un Subsonic classique présente la musique par tags (artiste / album). Gonic garde la structure physique du disque comme vue de premier ordre — utile quand le classement par tags est incomplet — et Feishin en donne une interface agréable.

⚙️ Configuration Docker

/opt/dockers/gonic/docker-compose.yml
services:
  gonic:
    image: sentriz/gonic:latest
    container_name: gonic
    restart: unless-stopped
    ports:
      - "8001:80"
    environment:
      - TZ=Europe/Paris
      - GONIC_MUSIC_PATH=/music
      - GONIC_PLAYLISTS_PATH=/playlists
      - GONIC_PODCASTS_PATH=/podcasts
      - GONIC_CACHE_PATH=/cache
      # Active la recherche / navigation par dossiers
      - GONIC_SCAN_INTERVAL=60
    volumes:
      # Stockage des données internes de Gonic (DB SQLite, cache)
      - ./data:/data
      - ./cache:/cache
      # Remplacer par le dossier réel sur l'hôte
      - /mnt/primidi/HDD_01/musique/MP3:/music:ro
      # Dossiers optionnels pour les playlists et podcasts
      - ./playlists:/playlists
      - ./podcasts:/podcasts

  feishin:
    image: ghcr.io/jeffvli/feishin:latest
    container_name: feishin
    restart: unless-stopped
    ports:
      - "8002:9180"

Bibliothèque montée en lecture seule

/music:ro : Gonic ne doit jamais écrire dans la musique. Les données qu'il produit (base SQLite, cache) restent dans ./data et ./cache.

📦 Démarrage

sur quartidi
cd /opt/dockers/gonic
docker compose up -d

Vérification des conteneurs :

sur quartidi
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

🧪 Première connexion et configuration

Étape 1 — Administration Gonic

  1. Ouvrir http://quartidi:8001 (ou http://192.168.1.104:8001).
  2. Identifiants par défaut : admin / admin.
  3. Sécurité : changer immédiatement le mot de passe de l'administrateur ou créer un compte utilisateur dédié dans User Management.

Étape 2 — Scan de la bibliothèque

Au démarrage, Gonic indexe automatiquement le dossier /music. La progression est visible sur la page d'accueil d'administration, bloc Stats (champs folders, albums, tracks).

Étape 3 — Connexion du client Feishin

  1. Ouvrir http://quartidi:8002.
  2. Sur l'écran SERVER REQUIRED, choisir OpenSubsonic (ou Subsonic).
  3. Renseigner :
Champ Valeur
Server Name Gonic Quartidi
URL http://quartidi:8001 (ou l'URL HTTPS via proxy, ex. https://gonic.moacmoa.duckdns.org)
Username le nom d'utilisateur Gonic
Password le mot de passe associé
Enable legacy authentication décoché

Authentification moderne

Laisser Enable legacy authentication décoché : Gonic gère le mode moderne Token + Salt.

  1. Cliquer sur ADD.

Étape 4 — Navigation par dossiers

Dans Feishin, cliquer sur Folders dans le panneau latéral pour parcourir l'arborescence brute de /mnt/primidi/HDD_01/musique/MP3.

🌐 Reverse proxy (optionnel)

Exposition en HTTPS sur le domaine DuckDNS via Nginx Proxy Manager :

  1. Gonic (API) : gonic.moacmoa.duckdns.org → port 8001 de l'hôte.
  2. Feishin (UI) : feishin.moacmoa.duckdns.org → port 8002 de l'hôte.
  3. Certificat SSL :
    • Port 80 WAN ouvert → challenge HTTP standard.
    • Port 80 WAN fermé ou réservé au LAN → DNS Challenge (provider DuckDNS) avec le token API pour délivrer le certificat Let's Encrypt.

Voir aussi

  • Airsonic — l'ancien serveur de streaming Subsonic de la maison.
  • Music Assistant — diffusion vers enceintes connectées.