← todos os projetos

Remote Wake

Open source

Plataforma self-hosted para ligar computadores remotamente por Wake-on-LAN, dentro e fora de casa, com PWA instalável e API autenticada.

O que é

O Remote Wake é uma plataforma open source e self-hosted para ligar, desligar, reiniciar, suspender e hibernar computadores remotamente. Junta Wake-on-LAN, um painel web instalável como PWA, uma API autenticada e dois componentes que rodam perto das máquinas (um gateway e um agente), para funcionar tanto dentro de casa quanto fora dela.

Cada pessoa tem a própria conta e cadastra as próprias máquinas. A instalação é feita por quem vai usar, com Docker, num PC, NAS, Raspberry Pi ou servidor, sem depender de serviço de terceiros.

O problema

Os aplicativos tradicionais de Wake-on-LAN costumam fazer uma coisa só: mandar o Magic Packet na rede local. Isso não ajuda quando você está fora de casa, quando a operadora coloca a conexão atrás de CGNAT, nem quando o que você quer é desligar ou reiniciar o computador, e não ligá-lo. Também não dizem se a máquina realmente ligou.

O Remote Wake tenta cobrir o caminho inteiro: acordar a máquina por vários meios, confirmar que ela subiu, executar as ações de energia quando ela está ligada e registrar tudo num histórico.

Como funciona

O painel conversa por HTTPS com a API. Para ligar uma máquina, a API tem três caminhos: mandar o pacote para o broadcast da rede local (ou por uma VPN que o encaminhe); mandar UDP para um IP público ou DDNS, o Wake-on-WAN, que exige redirecionamento de porta no roteador; ou entregar o pedido a um gateway residencial, um processo sempre ligado dentro da casa que busca os pedidos na API e envia o pacote na LAN ou pela rede Tailscale.

Uma máquina desligada não executa programas, então desligar, reiniciar, suspender e hibernar dependem de um agente instalado no Windows ou no Linux. O agente abre uma conexão de saída com a API e aceita só essas quatro ações: nada de shell arbitrário. Quando ele se conecta logo depois de um pedido de Ligar, o histórico registra que a máquina de fato ligou.

Um detalhe que o projeto deixa explícito: Tailscale instalado só no computador desligado não consegue acordá-lo. A API e o gateway precisam ficar em outro equipamento sempre ligado.

Tecnologias e decisões

A API é em ASP.NET Core 10 com C#, Entity Framework Core e PostgreSQL; as migrações rodam sozinhas na inicialização. Escolhi .NET pela boa integração com serviços do Windows, pelo suporte a Linux, pela biblioteca de rede e por permitir compartilhar o código do Magic Packet e do contrato entre API, gateway e agente. O painel é React com TypeScript e Vite.

Como o sistema controla máquinas, a segurança vem primeiro: sessões guardadas no servidor com cookie HttpOnly e SameSite=Strict, verificação em duas etapas (TOTP) com códigos de recuperação, cabeçalho obrigatório contra CSRF, limite de tentativas por IP e por conta, cadastro fechado depois da primeira conta (que exige um código de configuração exibido no log) e eventos de segurança visíveis no painel.

Para produção há imagens amd64 e arm64 publicadas no GitHub Container Registry e um modelo com Caddy fazendo o HTTPS.

Testes e estado atual

Os testes de unidade e de API usam xUnit v3 contra um PostgreSQL real e descartável. Os testes de navegador, com Playwright em desktop e celular, cobrem cadastro, máquinas, gateway, troca de senha, duas etapas e sessões, e reprovam qualquer erro no console, inclusive violação da CSP. Um script de integração sobe banco, API, gateway e agente e testa isolamento entre usuários, revogação e reinício. Tudo roda no GitHub Actions a cada push.

O projeto está em desenvolvimento: API, interface, gateway e agente foram validados ponta a ponta em simulação (há um modo de demonstração que não liga nem desliga nenhum PC), e o teste com computadores e redes reais ainda está pendente. Na fila estão o pareamento de gateways por código, vários gateways por conta e a interface em inglês.

Destaques

Stack

ASP.NET Core 10, C#, EF Core, PostgreSQL, React, TypeScript, Docker, Playwright

Código no GitHub

Projeto de Victor de Melo da Rosa.