110 lines
4.3 KiB
Markdown
110 lines
4.3 KiB
Markdown
---
|
|
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
|