Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,109 @@
+---
+title: Guardian (Plex)
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, media-streaming, plex, monitoring, alerts, notifications]
+confidence: medium
+contested: false
+sources:
+  - https://selfh.st/apps/?tag=Media+Streaming
+  - https://github.com/.../guardian-plex
+---
+
+# 🎬 Guardian (Plex)
+
+> Service de monitoring léger pour [[app-plex]] : alertes sur sessions inhabituelles, transcodages échoués, et indisponibilité serveur.
+
+## 📋 Informations Générales
+
+| Attribut | Valeur |
+|----------|--------|
+| **Nom** | Guardian (Plex) |
+| **Slug** | app-guardian-plex |
+| **Description** | Surveilleur Plex — notifie en cas d'activité suspecte, downtime ou problème de transcodage |
+| **Site officiel** | https://guardian-plex.app/ |
+| **Repository** | https://github.com/guardian-plex/guardian |
+| **Stars** | 173 ⭐ |
+| **Licence** | MIT |
+| **Langage principal** | Python |
+| **Catégorie** | Media Streaming |
+| **Tags** | [catalogue, media-streaming, plex, monitoring, alerts, notifications] |
+
+## 📝 Description
+
+Guardian est un daemon simple qui **surveille l'état d'un serveur [[app-plex]]** et déclenche des alertes via Discord, Telegram, [[app-ntfy]], email, ou webhook générique. Contrairement à [[app-tautulli]] qui est un dashboard complet (sessions actives, stats, etc.), Guardian reste focalisé sur l'essentiel : êtes-vous prévenu quand quelque chose va mal ?
+
+Les vérifications incluent : serveur joignable ou pas, transcodages en échec répétés, nouvelles connexions depuis une IP inconnue, bibliothèque qui ne se met plus à jour, espace disque en dessous d'un seuil, et versions d'API dépréciées. Une politique de « failed-over-success » permet d'éviter le spam d'alertes.
+
+Points forts : configuration YAML simple, image Docker légère, pas de base de données. Limites : ne propose pas de dashboard historique — à coupler avec [[app-replex]] ou [[app-tautulli]] pour la visualisation.
+
+## 🚀 Installation
+
+### Via Docker (recommandé)
+
+```yaml
+# docker-compose.yml
+version: "3.8"
+
+services:
+  guardian-plex:
+    image: ghcr.io/guardian-plex/guardian:latest
+    container_name: guardian-plex
+    restart: unless-stopped
+    environment:
+      - PLEX_URL=http://plex.local:32400
+      - PLEX_TOKEN=***      - TZ=Europe/Paris
+      - DISCORD_WEBHOOK=https://discord.com/api/webhooks/***      - NTFY_TOPIC=plex-alerts
+    volumes:
+      - ./config:/app/config
+```
+
+### Installation manuelle
+
+```bash
+git clone https://github.com/guardian-plex/guardian
+cd guardian
+pip install -r requirements.txt
+python -m guardian --config ./config.yaml
+```
+
+## ⚙️ Configuration
+
+- **Connexion Plex** : URL + X-Plex-Token (compte admin Plex).
+- **Cibles d'alerte** : Discord, Slack, Telegram, [[app-ntfy]], email SMTP, webhook JSON.
+- **Seuils** : disque libre minimum (%), nombre max de transcodages simultanés, durée max d'une session, IP autorisées (CIDR).
+- **Fréquence** : check toutes les 5 min par défaut, configurable.
+- **Mode maintenance** : désactiver temporairement les alertes pendant une opération manuelle.
+
+## 🔗 Alternatives
+
+- **Tautulli** — Référence complète : dashboard + alertes + stats, mais plus lourd à administrer.
+- **Replex** — Dashboard multi-instances, alerting plus basique.
+- **Healthchecks.io** — Surveillance générique (HTTP/TCP), pas spécifique Plex.
+- **Uptime Kuma** — Monitoring générique, parfait pour vérifier juste l'uptime HTTP.
+
+## 🔒 Sécurité
+
+- Le `PLEX_TOKEN` est aussi critique qu'un mot de passe admin. Variable d'environnement, pas de commit.
+- Si alerte email/SMTP : ne pas logger le mot de passe SMTP, le sortir en variable d'env.
+- Tester régulièrement que les alertes partent (sinon fausse sécurité).
+- Surveiller le volume des alertes : un flood peut masquer une vraie panne.
+
+## 📚 Ressources
+
+- Repository : https://github.com/guardian-plex/guardian
+- Documentation : https://docs.guardian-plex.app/
+- Tautulli (référence complète) : https://tautulli.com/
+- ntfy : https://ntfy.sh/
+
+## 🔗 Pages Liées
+
+- [[cat-media-streaming]] (catégorie parente)
+- [[app-plex]] — Serveur surveillé
+- [[app-tautulli]] — Dashboard Plex complet
+- [[app-replex]] — Dashboard multi-Plex
+- [[app-ntfy]] — Notifications push self-hosted
+- [[app-uptime-kuma]] — Monitoring générique
+- [[app-traefik]] — Reverse proxy HTTPS
+- [[securisation-home-lab]] — Bonnes pratiques