HydroshieldMKII/Guardian

O que é?

Recursos principais

• 01Aprovar, rejeitar ou manter dispositivos em espera, com exceções por usuário
• 02Limites de streams simultâneos globais e por usuário
• 03Listas de permissões de IP, regras para LAN/WAN e horários
• 04Sessões ao vivo, detalhes dos streams e histórico pesquisável
• 05Notificações por email, Apprise e pelo app
• 06Portal para usuários verem seus dispositivos e deixarem observações

Casos de uso

• Administradores domésticos que limitam quando e de onde os familiares podem assistir a streams
• Operadores de homelab que limitam streams simultâneos em um servidor Plex compartilhado
• Restringir o acesso de dispositivos desconhecidos ou de fora da rede doméstica

Início rápido

1. 1

   Crie uma pasta e entre nela

   mkdir -p guardian && cd guardian
2. 2

   Baixe o arquivo de exemplo do Docker Compose

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

   Inicie o Guardian com o Docker Compose e, em seguida, abra a interface web na porta 3000

   docker compose up -d

Antes de usar

• !Requer um Plex Media Server acessível e um token do Plex.
• !Licenciado sob a PolyForm Noncommercial 1.0.0, que proíbe o uso comercial.

Em coleções

Tópicos

Perguntas frequentes

O que é Guardian?

Camada de controle de acesso para Plex Media Server que aprova ou bloqueia dispositivos, aplica horários e regras de IP, limita streams e encerra sessões que violam as políticas. O Guardian funciona junto ao Plex Media Server e consulta a API de sessões. Cada stream ativo é comparado com as políticas definidas para o usuário e o dispositivo, e as sessões que não atendem às regras são encerradas.

Guardian é gratuito? Qual é a licença?

Guardian é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.

Guardian ainda é mantido?

Manutenção ativa. O último commit de Guardian foi em 3 de nov. de 2026.

Para que posso usar Guardian?

Administradores domésticos que limitam quando e de onde os familiares podem assistir a streams Operadores de homelab que limitam streams simultâneos em um servidor Plex compartilhado Restringir o acesso de dispositivos desconhecidos ou de fora da rede doméstica

Como instalar Guardian?

Crie uma pasta e entre nela: mkdir -p guardian && cd guardian Baixe o arquivo de exemplo do Docker Compose: curl -o docker-compose.yml https://raw.githubusercontent.com/HydroshieldMKII/Guardian/main/docker-compose.example.yml Inicie o Guardian com o Docker Compose e, em seguida, abra a interface web na porta 3000: docker compose up -d

Onde consigo Guardian?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/HydroshieldMKII/Guardian