Como funciona
O agente é um serviço do sistema (sayboot-agent.service) que roda com um usuário dedicado, sem interface gráfica. Ele desliga, reinicia, suspende e hiberna via systemd, autorizado por uma regra polkit instalada junto com o serviço: sem sudo, sem senha. O ligar vem do Echo com um magic packet; o agente mantém o Wake on LAN armado a cada inicialização, que é o motivo número um pelo qual, do contrário, ele para de funcionar depois de uma reinicialização.
Qual arquivo baixar
No Debian, Ubuntu e derivados (Mint, Pop!_OS, Raspberry Pi OS) use o pacote .deb: instala serviço, regra polkit e persistência do Wake on LAN de uma vez. Nas outras distribuições use o binário, que faz o mesmo com --install-system. O processador aparece com uname -m: x86_64 → amd64, aarch64 → arm64, armv7l → armv7.
| Sistema e processador | Arquivo |
|---|---|
| Debian/Ubuntu · Intel ou AMD de 64 bits | sayboot-agent-latest-amd64.deb |
| Debian/Ubuntu · ARM de 64 bits (Raspberry Pi 4/5, Raspberry Pi OS 64 bits) | sayboot-agent-latest-arm64.deb |
| Outras distribuições · Intel ou AMD de 64 bits | sayboot-agent-linux-amd64 |
| Outras distribuições · ARM de 64 bits | sayboot-agent-linux-arm64 |
| Outras distribuições · ARM de 32 bits (Raspberry Pi 2/3, NAS mais antigos) | sayboot-agent-linux-armv7 |
Todos os arquivos, com as somas de verificação SHA256SUMS, estão na página de versões. O arquivo é assinado com GPG (SHA256SUMS.asc): a chave pública está em sayboot.com/sayboot-release-key.asc, impressão digital 7163 54BC 551B 86C6 0B20 F676 5519 CD24 C7AC B9C6. Verifique com gpg --verify SHA256SUMS.asc SHA256SUMS e depois sha256sum -c SHA256SUMS.
Instalação
-
Instale o pacote. No Debian/Ubuntu e derivados, no terminal:
wget https://github.com/magdale76/sayboot-agent-releases/releases/latest/download/sayboot-agent-latest-amd64.deb sudo apt install ./sayboot-agent-latest-amd64.debNas outras distribuições com systemd, baixe o binário e instale-o como serviço:
chmod +x sayboot-agent-linux-amd64 sudo ./sayboot-agent-linux-amd64 --install-system Gere o código de vinculação. No app SayBoot vá em Dispositivos → Adicionar → Ligar sem navegador e copie o código de 8 caracteres. Ele vale 10 minutos e só uma vez: se expirar, gere outro.
-
Vincule o serviço com o código no lugar de
XXXXXXXX:sudo sayboot-agent --code XXXXXXXXO comando vincula em nome do serviço e o reinicia. Em poucos segundos o PC aparece como online no app SayBoot, com o nome de host do Linux; você pode renomeá-lo lá.
-
Verifique e arme o Wake on LAN.
systemctl status sayboot-agent sudo sayboot-agent --fix-wol auto sudo sayboot-agent --diagnoseA primeira linha deve dizer active (running). A segunda arma o magic packet na placa Ethernet conectada e o rearma a cada inicialização. A terceira gera um relatório (placas de rede, Wake on LAN, permissões) que chega ao suporte SayBoot: se algo estiver errado, lemos juntos.
Teste com a Alexa. Diga «Alexa, descobrir dispositivos» e aguarde a confirmação. Depois «Alexa, desligar nome do PC»: desligamento limpo, como pelo menu. Com o PC desligado, «Alexa, ligar nome do PC»: o Echo envia o magic packet, o PC inicia e o serviço volta a ficar online sozinho.
O nome que a Alexa reconhece é o do dispositivo no app SayBoot.
O que esperar
- Desligar, reiniciar, suspender e hibernar funcionam se a distribuição suportar (hibernar exige swap suficiente; o app mostra só as ações que o agente declara).
- Desligamento agendado e ligar agendado pelo app SayBoot. Para ligar, o agente também arma o alarme de hardware do PC (RTC), assim a regra dispara mesmo desligado e sem Echo na rede, se o BIOS permitir («Power on by RTC»).
- Dual boot: o magic packet liga o PC, mas qual sistema inicia é decidido pelo BIOS ou pelo GRUB. Se o padrão for o Windows, depois de «Alexa, ligar» vai iniciar o Windows e será o agente Windows a responder. Defina o Linux como padrão se quiser que o serviço Linux responda.
- Wi-Fi: quase nenhuma placa Wi-Fi consegue ligar um PC desligado. É preciso o cabo Ethernet, pelo menos para ligar.
- Todos os arquivos do serviço (configuração, registro, relatórios) ficam em
/var/lib/sayboot. Registro ao vivo:journalctl -u sayboot-agent -f.
Se algo der errado
- O PC não aparece online.
systemctl status sayboot-agentejournalctl -u sayboot-agent -n 50dizem por quê. Se o serviço estiver parado com «not paired», repita o passo 3 com um código novo. - Desliga mas não liga de novo. Execute
sudo sayboot-agent --diagnosee procurewol_disabled_linuxouwol_unsupported_adapter. Depois o BIOS: «Wake on LAN», «Power on by PCI-E» ou «Resume by LAN» devem estar ativos e «ErP» desativado. - «Alexa, desligar» não faz nada. Uma entrada
logind_deniedno relatório indica que o polkit não autoriza o serviço:sudo sayboot-agent --install-systemreescreve a regra. - Atualização. Baixe o pacote de novo e repita
sudo apt install ./sayboot-agent-latest-amd64.deb: o serviço reinicia com a nova versão e a vinculação permanece. - Remoção.
sudo apt remove sayboot-agent(ousudo sayboot-agent --uninstallse usou o binário). A pasta/var/lib/saybootpermanece: apague-a para esquecer também a vinculação.
Precisa de ajuda?
Escreva para hello@sayboot.com informando distribuição e modelo, ou execute sudo sayboot-agent --diagnose: o relatório chega direto para nós. Esta página está em sayboot.com/linux/pt.
Linux é uma marca registrada de Linus Torvalds. Debian, Ubuntu e Raspberry Pi são marcas de seus respectivos titulares. Alexa, Amazon e Echo são marcas da Amazon.com, Inc. ou de suas afiliadas. O SayBoot é um aplicativo independente e não é afiliado, endossado nem patrocinado por eles.
