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 (
8001sur 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 (
8002sur 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¶
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¶
Vérification des conteneurs :
🧪 Première connexion et configuration¶
Étape 1 — Administration Gonic¶
- Ouvrir
http://quartidi:8001(ouhttp://192.168.1.104:8001). - Identifiants par défaut :
admin/admin. - 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¶
- Ouvrir
http://quartidi:8002. - Sur l'écran SERVER REQUIRED, choisir OpenSubsonic (ou Subsonic).
- 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.
- 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 :
- Gonic (API) :
gonic.moacmoa.duckdns.org→ port8001de l'hôte. - Feishin (UI) :
feishin.moacmoa.duckdns.org→ port8002de l'hôte. - 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.