🎬 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é)

# 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

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

4.3 KiB Raw Permalink Blame History