Sobre LocalGuard

1. O que é o LocalGuard

O LocalGuard é um sistema de controle parental que funciona inteiramente na sua rede doméstica. Não depende de servidores externos — todo o processamento acontece no seu servidor Docker.

Nasce de uma ideia simples: o controle parental não deveria obrigá-lo a entregar a atividade digital da sua família a um provedor externo. O projeto foi pensado para ser implantado na sua rede e operar como infraestrutura doméstica, não como serviço opaco.

2. Princípios operacionais

• Local first: as decisões e o estado vivem no seu próprio hardware.
• Privacidade absoluta: zero telemetria e zero dependência funcional de terceiros.
• Código auditável: o projeto pode ser revisado, implantado e estendido sem caixas pretas.
• Operação realista: Docker Compose, VPS e hardware doméstico sem arquitetura inflada.

3. Arquitetura do sistema

O LocalGuard é composto por três peças que trabalham juntas dentro da sua rede:

Core (servidor)

Backend em Go que concentra lógica, orquestração e persistência. É o cérebro do sistema: toma todas as decisões de filtragem, armazena logs e expõe a API REST.

Agente Windows

Binário nativo instalado em cada PC que você deseja monitorar. Reporta atividade de rede e processos ao Core, aplica regras configuradas e inspeciona tráfego SNI sem quebrar HTTPS.

Painel web

Frontend React acessível de qualquer dispositivo na sua rede local. Exibe status, configura regras, horários e gerencia dispositivos.

4. Stack tecnológico

• Backend: Go 1.24, API REST, arquitetura hexagonal.
• Frontend: React 19, Vite, Tailwind CSS, i18next (6 idiomas).
• Agente: Go compilado para Windows (amd64), serviço nativo com watchdog.
• Autenticação: Tokens PASETO v4, senhas com hash bcrypt.
• Banco de dados: SQLite — sem dependências externas, portável, backup trivial.

5. Implantação

O LocalGuard é implantado com Docker Compose em qualquer máquina Linux, Windows ou Mac.

• Docker em qualquer servidor doméstico ou VPS.
• Servidor Docker como ponto de controle dedicado.
• Sem requisitos de nuvem, domínio público ou IP fixo externo.

Fundación y Liderazgo

Privacidad por Diseño

En LocalGuard, la privacidad no es una configuración, es nuestra arquitectura fundamental. A diferencia de las soluciones comerciales que prometen privacidad mientras recopilan "telemetría anónima", nuestro código está diseñado para que sea técnicamente imposible que veamos tus datos.

6. Código aberto

O código-fonte completo do projeto está disponível publicamente no GitHub.

Você pode auditar cada linha, implantar sua própria instância e contribuir para o desenvolvimento. Não há dependências ocultas ou componentes proprietários.

7. Contato

Para qualquer dúvida sobre o projeto, escreva para [email protected].