Repolode
Enviar
HydroshieldMKII

HydroshieldMKII/Guardian

Capa de control de acceso para Plex Media Server que aprueba o bloquea dispositivos, aplica horarios y reglas de IP, limita las transmisiones y cierra las sesiones que incumplen las normas.

Ver en GitHub
Estrellas
175
Forks
7
Issues abiertos
13
Último commit
hace 4 días

¿Qué es?

Guardian funciona junto a Plex Media Server y consulta periódicamente su API de sesiones. Cada transmisión activa se compara con las políticas del usuario y del dispositivo, y se terminan las sesiones que no cumplen las reglas.

Los administradores pueden aprobar, rechazar o dejar en espera dispositivos nuevos, con excepciones por usuario, listas de IP permitidas, reglas para LAN/WAN, horarios y permisos temporales. Se admiten límites de transmisiones simultáneas globales y por usuario. La interfaz web muestra sesiones en tiempo real, detalles de las transmisiones e historial con búsqueda.

Los usuarios de Plex disponen de un portal donde pueden ver sus propios dispositivos y dejar notas. Se pueden enviar notificaciones por correo electrónico, Apprise o dentro de la aplicación. Se implementa con Docker Compose y requiere un servidor Plex accesible y un token de Plex.

Funciones clave

  • 01Aprobar, rechazar o dejar en espera dispositivos, con excepciones por usuario
  • 02Límites de transmisiones simultáneas globales y por usuario
  • 03Listas de IP permitidas, reglas para LAN/WAN y horarios
  • 04Sesiones en tiempo real, detalles de las transmisiones e historial con búsqueda
  • 05Notificaciones por correo electrónico, Apprise y dentro de la aplicación
  • 06Portal de usuario para consultar dispositivos y dejar notas

Casos de uso

  • Administradores del hogar que limitan cuándo y desde dónde pueden transmitir los miembros de la familia
  • Operadores de homelab que limitan las transmisiones simultáneas en un servidor Plex compartido
  • Restringir el acceso desde dispositivos desconocidos o fuera de la red doméstica

Inicio rápido

  1. 1

    Crea una carpeta y accede a ella

    mkdir -p guardian && cd guardian
  2. 2

    Descarga el archivo de ejemplo de Docker Compose

    curl -o docker-compose.yml https://raw.githubusercontent.com/HydroshieldMKII/Guardian/main/docker-compose.example.yml
  3. 3

    Inicia Guardian con Docker Compose y, después, abre la interfaz web en el puerto 3000

    docker compose up -d

Antes de usarlo

  • Requiere un Plex Media Server accesible y un token de Plex.
  • Está bajo la licencia PolyForm Noncommercial 1.0.0, que prohíbe el uso comercial.

En colecciones

Apps autoalojadas

Temas

#plex-server#access-control#self-hosted#docker#media-server#monitoring#homelab#media-player#nestjs#nextjs

Preguntas frecuentes

¿Qué es Guardian?
Capa de control de acceso para Plex Media Server que aprueba o bloquea dispositivos, aplica horarios y reglas de IP, limita las transmisiones y cierra las sesiones que incumplen las normas. Guardian funciona junto a Plex Media Server y consulta periódicamente su API de sesiones. Cada transmisión activa se compara con las políticas del usuario y del dispositivo, y se terminan las sesiones que no cumplen las reglas.
¿Guardian es gratuito? ¿Qué licencia tiene?
Guardian es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Guardian sigue mantenido?
Mantenimiento activo. El último commit de Guardian fue el 3 nov 2026.
¿Para qué puedo usar Guardian?
Administradores del hogar que limitan cuándo y desde dónde pueden transmitir los miembros de la familia Operadores de homelab que limitan las transmisiones simultáneas en un servidor Plex compartido Restringir el acceso desde dispositivos desconocidos o fuera de la red doméstica
¿Cómo se instala Guardian?
Crea una carpeta y accede a ella: mkdir -p guardian && cd guardian Descarga el archivo de ejemplo de Docker Compose: curl -o docker-compose.yml https://raw.githubusercontent.com/HydroshieldMKII/Guardian/main/docker-compose.example.yml Inicia Guardian con Docker Compose y, después, abre la interfaz web en el puerto 3000: docker compose up -d
¿Dónde consigo Guardian?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/HydroshieldMKII/Guardian

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados