Repository Public
1# Déploiement — MacLustr23SP TV est déployée par `mld` (maclustr-dispatch) comme les autres applications du cluster. Rien d'autre n'a été modifié4sur le cluster.56| Élément | Valeur |7|---|---|8| URL | https://tv.spboucher.ai |9| App `mld` | `sp-tv` (manifeste `M1M32:~/dispatch/apps/sp-tv.json`) |10| Nœud | **m4mn** (Mac mini M4 Pro, épinglé), dossier `~/apps/sp-tv` = clone git, `origin` = spbgit `sp-tv.git` |11| Port | **8670** (HTTP, écoute sur toutes les interfaces ; seul le tunnel y accède de l'extérieur) |12| Reverse proxy HTTPS | Caddy sur la passerelle BHS64 (certificat Let's Encrypt automatique, HTTP → HTTPS), route posée par `mld deploy`, trafic acheminé par WireGuard (`wg1`) |13| DNS | `A tv.spboucher.ai → 51.161.112.61` (déjà en place le 2026-11-16, vérifié avant le déploiement) |14| Processus PM2 | `sp-tv-web` (`next start`), `sp-tv-worker` (tsx), `sp-tv-backup` (cron 03:50) |15| Données | `~/data/sp-tv/sp-tv.db` (SQLite, WAL), `~/data/sp-tv/epg-grabber/` (outil IPTV-org, ~260 Mo), `~/data/sp-tv/epg/`, `~/data/sp-tv/transcode/` (conversions vidéo, borné à 30 Go par défaut), `~/data/sp-tv/thumbs/` |16| Bibliothèque | `~/media/sp-tv/` (films libres de démonstration) ; NAS : voir ci-dessous |17| Sauvegardes | `~/backups/sp-tv/sp-tv-AAAAMMJJ-HHMMSS.db.gz`, 14 jours |18| Secrets | `~/apps/sp-tv/.env` (600) ; copie : laptop `~/Desktop/Cluster/secrets/sp-tv/` |19| Dépendances | Node.js ≥ 24 (26 installé ; `node:sqlite`), pnpm, pm2, git + npm (pour le grabber EPG), `/usr/bin/sqlite3` (sauvegarde), **ffmpeg + ffprobe** (`brew install ffmpeg`, installés le 2026-11-16 ; analyse et conversion de la bibliothèque) |2021Redémarrage automatique : PM2 (`autorestart`), `pm2 resurrect` à l'ouverture de session du nœud, et `mld heal` toutes les225 minutes depuis la passerelle (relance PM2, tunnel et route si nécessaire).2324## Première installation (déjà faite le 2026-11-16)2526```bash27# 1. secrets sur le nœud28ssh m4mn 'mkdir -p ~/apps/sp-tv ~/data/sp-tv ~/backups/sp-tv && cd ~/apps/sp-tv && cp .env.example .env && chmod 600 .env' # puis remplir APP_SECRET, DATA_DIR, BACKUP_DIR29# 2. manifeste M1M32:~/dispatch/apps/sp-tv.json, puis30mld stage ~/Desktop/Cluster/projets/sp-tv sp-tv31mld deploy sp-tv --node m4mn # rsync, pnpm install, bootstrap, next build, PM2, route tunnel, santé32mld adopt sp-tv # le dossier déployé devient un clone git33```3435`scripts/bootstrap.ts` (hook de déploiement, idempotent) crée la base et, s'il n'y en a pas, un mot de passe aléatoire36écrit une seule fois dans `~/data/sp-tv/initial-password.txt` (600). Le worker lance la première synchronisation au démarrage.3738## Mettre à jour (remote-first : sur le nœud)3940```bash41ssh m4mn42cd ~/apps/sp-tv && export PATH=/opt/homebrew/bin:$PATH43# … modifier, ou git pull …44pnpm install --frozen-lockfile45node_modules/.bin/next build46pm2 restart sp-tv-web sp-tv-worker47git add -A && git commit -m "…" && git push origin main48```4950Les migrations de la base (`MIGRATIONS` dans `src/server/db.ts`) s'appliquent seules au démarrage ; ne jamais modifier une51migration déjà appliquée, en ajouter une.5253## Bibliothèque et NAS Ugreen5455État constaté le 2026-11-16 : **les deux NAS Ugreen sont injoignables** (aucun montage `~/nas_clustr` / `~/nas2_clustr` sur56m4mn ni sur les autres nœuds vérifiés, port SMB fermé aux adresses 192.168.2.173 et .175, aucune adresse MAC `6c:1f:f7:…`57sur le réseau local). m4mn n'a pas non plus les scripts de montage automatique des anciens nœuds. La bibliothèque a donc58été validée avec un dossier local (`~/media/sp-tv`, films Blender sous licence Creative Commons).5960Pour brancher un NAS quand il sera rallumé :61621. Monter le partage sur m4mn (Finder → Se connecter au serveur `smb://<ip-du-nas>/clustr`, ou le script63 `~/bin/nas_automount.sh` des autres nœuds) : il apparaît sous `/Volumes/clustr` ou `~/nas_clustr`.642. Admin → Bibliothèque → Ajouter un dossier (ex. `/Volumes/clustr/media/movies`, type Films). Seuls les emplacements sous65 `~/media`, `~/nas_clustr`, `~/nas2_clustr` et `/Volumes` sont acceptés (variable `LIBRARY_ROOTS` pour en changer).663. L'analyse démarre aussitôt puis toutes les 15 minutes. Si le NAS s'éteint, le dossier passe « inaccessible » et son67 catalogue est conservé.6869Non vérifié : la lecture depuis un vrai partage SMB (débit, droits macOS d'accès aux volumes réseau pour un processus PM2).7071## Jellyfin (installé le 2026-11-17)7273App `mld` **`jellyfin`** sur m4mn, port 8096, URL de base `/jellyfin` (dépôt `jellyfin.git`, dossier `~/apps/jellyfin` :74`install.sh`, `start.sh`, `setup.sh`). Binaire officiel portable dans `~/opt/jellyfin/12.4`, données dans `~/data/jellyfin`,75mot de passe administrateur dans `~/.config/jellyfin/admin-password` (copie : laptop `~/Desktop/Cluster/secrets/jellyfin/`).7677- **Publication** : pas de nom de domaine propre. SP TV le publie sous `https://tv.spboucher.ai/jellyfin/` par une78 réécriture (`JELLYFIN_PROXY=http://127.0.0.1:8096` dans `.env`, lue au `next build`) ; `src/proxy.ts` passant avant,79 Jellyfin n'est joignable qu'avec une session SP TV ouverte, en HTTPS.80- **Administration de Jellyfin** à la maison : `http://192.168.2.93:8096/jellyfin/web/` (compte `sp`). L'interface web de81 Jellyfin à travers SP TV n'a pas été validée (elle n'est pas nécessaire : SP TV lit la bibliothèque par l'API).82- **Bibliothèques** : « Films » et « Séries » sur `~/media/sp-tv/…` (films libres de démonstration), « Mes films » et83 « Mes séries » sur `~/media/jellyfin/films` et `~/media/jellyfin/series` (vides : déposez-y vos fichiers).84 Après un dépôt de fichiers, Jellyfin les indexe à son rythme ; SP TV les reprend à l'actualisation quotidienne des85 sources (ou Admin → Sources → Actualiser).86- **Dans SP TV** : source « Jellyfin (m4mn) » (Admin → Sources), adresse interne `http://127.0.0.1:8096/jellyfin`, adresse87 vue par les appareils `https://tv.spboucher.ai/jellyfin`.88- Les quatre titres de démonstration existent donc deux fois dans SP TV (bibliothèque intégrée et Jellyfin) : retirez l'un89 des deux (Admin → Bibliothèque, ou désactivez la source Jellyfin) selon l'outil que vous préférez.90- Mise à niveau : `JELLYFIN_VERSION=x.y ./install.sh && pm2 restart jellyfin`. Non sauvegardé automatiquement.9192## Relay Engine (installé le 2026-11-17)9394Processus PM2 `sp-tv-relay` (`scripts/relay-start.sh` : génère `~/data/sp-tv/relay/mediamtx.yml` puis lance95`~/opt/mediamtx/mediamtx`, installé par `scripts/relay-install.sh`). Ports 8672 à 8675, boucle locale uniquement.96FFmpeg vient de Homebrew. Le manifeste mld (`M1M32:~/dispatch/apps/sp-tv.json`) contient le processus, les ports et97l'installation de MediaMTX en `post_sync`. Exploitation et réglages : `RELAY.md`.9899## TMDB100101`TMDB_API_KEY` dans `.env` (ajoutée le 2026-11-17). Passe d'enrichissement à la fin de l'import hebdomadaire des films, ou102à la main : `node_modules/.bin/tsx scripts/run-job.ts tmdb`. Mention d'attribution affichée sur les fiches concernées et103dans Paramètres.104105## Exploitation106107```bash108mld status --live | grep sp-tv # état vu de la passerelle109mld logs sp-tv # journaux PM2110ssh m4mn 'pm2 logs sp-tv-worker --lines 100 --nostream'111ssh m4mn 'pm2 logs sp-tv-web --lines 100 --nostream'112curl -s https://tv.spboucher.ai/api/health113```114115Les journaux applicatifs (synchronisations, guide, lots de tests, connexions, erreurs) sont aussi dans **Admin → Journaux**116(30 jours conservés) ; les fichiers PM2 sont dans `~/.pm2/logs/sp-tv-*.log`.117118Tâches manuelles sur le nœud (dans `~/apps/sp-tv`) :119120```bash121node_modules/.bin/tsx scripts/run-job.ts sync # synchronisation immédiate122node_modules/.bin/tsx scripts/run-job.ts epg # guide TV123node_modules/.bin/tsx scripts/run-job.ts check 50 # teste 50 flux, détail à l'écran124node_modules/.bin/tsx scripts/run-job.ts vod # films et séries libres125node_modules/.bin/tsx scripts/run-job.ts library # analyse de la bibliothèque126node_modules/.bin/tsx scripts/set-password.ts # nouveau mot de passe aléatoire, ferme toutes les sessions127```128129## Sauvegarde et restauration130131`sp-tv-backup` exécute `scripts/backup.sh` chaque nuit à 03:50 : copie cohérente à chaud (`sqlite3 .backup`), contrôle132d'intégrité, gzip, purge après 14 jours. Lancer à la main : `ssh m4mn 'cd ~/apps/sp-tv && bash scripts/backup.sh'`.133134```bash135# restauration136pm2 stop sp-tv-web sp-tv-worker137gunzip -c ~/backups/sp-tv/sp-tv-AAAAMMJJ-HHMMSS.db.gz > ~/data/sp-tv/sp-tv.db138rm -f ~/data/sp-tv/sp-tv.db-wal ~/data/sp-tv/sp-tv.db-shm139pm2 start sp-tv-web sp-tv-worker140```141142Limite : les sauvegardes sont sur le même disque que la base. Seul l'état personnel (favoris, listes, masquées,143paramètres, clés d'accès) est irremplaçable ; le catalogue et le guide se reconstruisent par synchronisation.144145Ne pas faire `mld move sp-tv` sans copier `~/data/sp-tv/sp-tv.db` : la base ne suit pas l'application.146147## Dépannage148149| Symptôme | Vérifier |150|---|---|151| Admin affiche « Le worker ne répond pas » | `pm2 describe sp-tv-worker`, `pm2 logs sp-tv-worker` ; `pm2 restart sp-tv-worker` |152| Synchronisation en échec | Admin → Aperçu → Tâches récentes (erreur par source) ; `curl -I https://iptv-org.github.io/iptv/index.m3u` depuis le nœud |153| Guide vide | Admin → Journaux, composant `epg` ; `ls ~/data/sp-tv/epg-grabber` ; relancer `run-job.ts epg` ; supprimer `epg-grabber/` force une réinstallation |154| Site injoignable | `mld health sp-tv`, `mld tunnel status`, `mld heal` |155| Un fichier de la bibliothèque ne se lit pas | Admin → Bibliothèque (mode de lecture, erreurs d'analyse) ; `pm2 logs sp-tv-web` (erreur ffmpeg) ; `rm -rf ~/data/sp-tv/transcode/<id>-a0` force une nouvelle conversion |156| Films absents | Admin → Films et séries → Mettre à jour ; Journaux, composant `vod` (Wikidata ou Wikipédia peuvent limiter le débit : relancer plus tard) |157| Mot de passe perdu | `scripts/set-password.ts` sur le nœud |158| Trop de tentatives de connexion | attendre 15 min, ou `sqlite3 ~/data/sp-tv/sp-tv.db 'DELETE FROM login_attempts'` |159| Tout marque « indisponible » | le nœud a-t-il Internet ? `run-job.ts check 20` montre la cause par flux |160