# WakeMe relay Raspberry — 0.1.3

Raspberry Pi OS Lite 64 bit, Raspberry Pi 4, Ethernet nella stessa LAN del PC. Il relay usa Node.js >=22 senza dipendenze npm, senza Electron e senza privilegi root. Il PC destinatario non deve eseguire Tailscale. Il WoL locale deve già funzionare.

## 1. Installazione

Installa Tailscale seguendo https://tailscale.com/download/linux/rpi e accedi alla stessa tailnet del telefono/Mac con `sudo tailscale up`. Abilita MagicDNS e certificati HTTPS dalla console Tailscale. Installa Node.js >=22 per ARM64 (https://nodejs.org/en/download) e verifica `node --version`. L'unità assume `/usr/bin/node`: se Node è altrove, modifica ExecStart con il percorso assoluto. Non usare un Node disponibile soltanto tramite nvm nell'utente interattivo.

Scarica l'archivio relay dal sito WakeMe e controlla il relativo SHA256SUMS.txt. Copialo sul Raspberry, poi:

```sh
sudo useradd --system --user-group --home-dir /var/lib/wakeme --shell /usr/sbin/nologin wakeme
sudo install -d /opt/wakeme /etc/wakeme
sudo tar -xzf WakeMe-0.1.3-relay.tar.gz -C /opt/wakeme
sudo cp /opt/wakeme/relay/config.example.json /etc/wakeme/config.json
sudo nano /etc/wakeme/config.json
```

Sostituisci origin con l'URL HTTPS completo del Raspberry (nome MagicDNS completo da `tailscale status --json`, campo Self.DNSName, senza il punto finale), allowedUsers con il login esatto della tua identità Tailscale, MAC e broadcast con quelli reali della LAN. Il MAC incluso è fittizio: non è Woodmuseo. Per questo esempio l'identificativo rimane `woodmuseo`. Non inserire password o chiavi Tailscale.

```sh
sudo chown root:wakeme /etc/wakeme/config.json
sudo chmod 640 /etc/wakeme/config.json
sudo cp /opt/wakeme/relay/wakeme-relay.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now tailscaled wakeme-relay
sudo tailscale serve --bg http://127.0.0.1:43812
sudo tailscale serve status
sudo systemctl status wakeme-relay
```

Serve mantiene la configurazione in background dopo il riavvio. Usa Serve, mai Funnel. Node ascolta soltanto su 127.0.0.1:43812: non aprire porte sul router o il binding su LAN. Un accesso curl diretto a loopback senza identità riceve 403, come previsto.

## 2. Limita gli accessi Tailscale

Nella console assegna al solo Raspberry il tag `tag:wakeme`. Aggiungi il tag e la grant seguente alla policy esistente, sostituendo il login. NON sostituire tutta la policy: potresti interrompere altri servizi (es. zen1).

```json
{
  "tagOwners": {"tag:wakeme": ["autogroup:admin"]},
  "grants": [{"src": ["TUO-LOGIN-TAILSCALE"], "dst": ["tag:wakeme"], "ip": ["tcp:443"]}]
}
```

Le grant e le ACL sono additive: una regola generale `* → *` continuerebbe a concedere accesso. Rimuovi o restringi le regole ampie che includono questo Raspberry, conservando gli accessi necessari agli altri dispositivi. Usa i test della policy per verificare che l'identità consentita raggiunga 443 e una non consentita non la raggiunga. La allowlist allowedUsers del relay costituisce un secondo controllo obbligatorio.

Telefono e Mac client devono appartenere a un utente, senza tag: i client con identità tag non forniscono Tailscale-User-Login e vengono rifiutati. Il Raspberry di destinazione può avere tag. Nessun token applicativo viene creato, memorizzato o scritto nei log. Si fidano solo delle identità inserite da Tailscale Serve su loopback; gli altri processi locali del Raspberry rientrano nel perimetro fidato. Non configurare proxy diversi o Funnel davanti al relay.

## 3. Uso

Sul telefono attiva Tailscale e apri in Safari `https://raspberry.nome-tailnet.ts.net`. La pagina WakeMe mostra soltanto i PC configurati sul Raspberry. Puoi aggiungere il collegamento alla schermata Home; non è un'app offline.

Nel desktop WakeMe 0.1.3 scegli Aggiungi PC (o Configura su un PC esistente), modalità Relay Raspberry, URL HTTPS e identificativo `woodmuseo`. Il MAC e il broadcast remoti rimangono nella configurazione Raspberry. L'app desktop non necessita di essere collegata alla LAN di casa. La modalità locale resta disponibile.

API: `POST /api/devices/woodmuseo/wake`, Content-Type application/json, body `{}`. Risposta `{ "device":"woodmuseo", "status":"wol_sent", "sent":3 }`. Nessun GET accende il PC. Si possono comandare solo identificativi configurati; MAC e comandi arbitrari inviati dal client non vengono usati. La risposta attesta l'invio, non l'accensione. La conferma del risultato resta manuale.

## 4. Collaudo reale

1. Prova il vecchio WoL locale e il relay dalla LAN con Tailscale connesso.
2. Arresta normalmente Woodmuseo, mantenendo alimentazione ed Ethernet.
3. Sul telefono disattiva Wi-Fi, usa rete mobile e connetti Tailscale; apri la pagina relay e premi Accendi. Controlla fisicamente o tramite un accesso remoto separato che il PC sia partito.
4. Prova un'identità non inclusa in allowedUsers: deve ricevere 403 (o essere bloccata prima dalla policy). Con policy autorizzata, un ID inesistente deve ricevere 404. Disconnetti Tailscale o arresta il servizio: l'app deve segnalare relay irraggiungibile/timeout. Il browser può mostrare un errore di connessione se l'intera pagina è irraggiungibile.
5. Riavvia Raspberry e ripeti da rete mobile; verifica `systemctl is-active tailscaled wakeme-relay` e `tailscale serve status`. Gestisci la scadenza delle chiavi del Raspberry nella console Tailscale secondo la tua policy.

Diagnosi: `journalctl -u wakeme-relay -n 50 --no-pager`. Non vengono registrati token, corpi richieste o identità. Dopo modifiche al config usa `sudo systemctl restart wakeme-relay`. Stato e ultimi 100 eventi in /var/lib/wakeme/state.json, accessibili al solo utente di servizio. Per fermare: `sudo systemctl disable --now wakeme-relay` e disabilita solo il Serve dedicato con `sudo tailscale serve --https=443 off` (non farlo se condividi la porta con altri servizi).

Documentazione ufficiale: [Serve](https://tailscale.com/docs/features/tailscale-serve), [CLI e persistenza](https://tailscale.com/docs/reference/tailscale-cli/serve), [grant additive](https://tailscale.com/docs/features/access-control/grants/grants-explained).
