Dashboard Home
Prima di tutto: non staccare la corrente senza spegnere
La SD card si può corrompere. Per spegnere in sicurezza: ssh stefano@192.168.200.1 → sudo shutdown -h now → aspetta che il LED verde del Pi5 si spenga completamente.
Servizi installati
nginxauto-avvio
Server web principale. Serve tutto il sito, gestisce HTTPS, proxy verso API e Kiwix. Se cade, nulla è raggiungibile.
avviasudo systemctl start nginx
fermasudo systemctl stop nginx
ricarica configsudo systemctl reload nginx
Kiwix — Wikipediaauto-avvio
Serve Wikipedia italiana offline (28 GB). Richiede il file ZIM in /var/lib/kiwix/. Accessibile su /wiki/.
avviasudo systemctl start kiwix
fermasudo systemctl stop kiwix
statosudo systemctl status kiwix
casamia-apiauto-avvio
API Node.js (porta 9001). Gestisce autenticazione, sessioni, controllo servizi e bollettino. Se cade, il login non funziona.
avviasudo systemctl start casamia-api
fermasudo systemctl stop casamia-api
log livesudo journalctl -fu casamia-api
WiFi AP — Ark Web Servermanuale
Access point WiFi. Spento di default al boot. Attivabile da Impostazioni o da terminale. Subnet: 10.42.0.0/24
avviasudo nmcli con up "CasaMia-AP"
fermasudo nmcli con down "CasaMia-AP"
MotoGirimanuale
Gestione gite in moto. Parte manualmente dalla dashboard. Porta 3000 (raggiungibile solo in rete locale).
avviasudo systemctl start motogiri
fermasudo systemctl stop motogiri
Airgrid PBX Agentmanuale
Agente IA vocale per centralino. Parte manualmente. Richiede connessione all'hardware PBX Airgrid.
avviasudo systemctl start airgrid-agent
fermasudo systemctl stop airgrid-agent
Indirizzi di rete
IndirizzoQuando è disponibile
192.168.200.1 Sempre presente — IP statico permanente su eth0. Raggiungibile con cavo diretto, indipendente da qualsiasi router. Questo è l'indirizzo di emergenza.
192.168.178.161 Solo quando collegato al Fritzbox di casa. Assegnato via DHCP — può cambiare.
stegani.sytes.net Sempre risolvibile in rete locale (dnsmasq punta a 192.168.200.1). Da internet richiede DDNS aggiornato.
10.42.0.1 Solo quando il WiFi AP è attivo. È il gateway per i dispositivi connessi all'AP "Ark Web Server".
Scenari di emergenza
1
Internet assente — rete locale funzionante Scenario principale
✓
Cosa funziona senza internet
Wikipedia (Kiwix, 28 GB in locale) · Mappe (tile cachati dal browser) · Bollettino · Dashboard completa · SSH · tutti i servizi locali.
✗
Cosa NON funziona senza internet
Aggiornamento Wikipedia (richiede download ~28 GB) · nuovi tile mappa non ancora cachati · rinnovo certificato HTTPS (Let's Encrypt, ogni 90 gg).
→
Accesso
Naviga normalmente a https://stegani.sytes.net dalla rete locale — dnsmasq risolve il nome anche senza DNS esterno.
2
Nessun router — cavo diretto laptop ↔ Pi5 Emergenza totale
1
Collega il cavo ethernet
Cavo diretto tra laptop e Pi5. Il laptop riceve automaticamente un IP nel range 192.168.200.100–200 via DHCP (dnsmasq sul Pi5). DNS: 192.168.200.1.
2
Apri il browser
Vai a https://stegani.sytes.net — il DNS del Pi5 risolve il nome a 192.168.200.1, il certificato HTTPS è valido. In alternativa diretta: https://192.168.200.1 (ma mostra avviso certificato).
3
Se il laptop non prende IP in automatico
Imposta manualmente: IP 192.168.200.50, maschera 255.255.255.0, gateway e DNS 192.168.200.1.
3
Accesso WiFi senza router Più dispositivi
1
Attiva il WiFi AP dal Pi5
Vai su Impostazioni → pannello WiFi AP → Start. Oppure via SSH:
sudo nmcli con up "CasaMia-AP"
2
Connetti i dispositivi
Rete WiFi: Ark Web Server. Nessuna password (rete aperta — usare solo in contesti fidati). I dispositivi ricevono IP via DHCP e usano 10.42.0.1 come gateway.
3
Apri il sito
Naviga a https://stegani.sytes.net — funziona uguale.
4
Accesso SSH di emergenza Amministrazione
→
Con cavo (IP sempre disponibile)
ssh stefano@192.168.200.1
→
In rete locale con router
ssh stefano@192.168.178.161
→
Comandi di sistema utili
sudo shutdown -h now # spegni in sicurezza sudo reboot # riavvia sudo systemctl status # stato di tutti i servizi df -h # spazio disco free -h # RAM disponibile vcgencmd measure_temp # temperatura CPU
5
Il sito non risponde — diagnosi rapida Troubleshooting
1
Controlla tutti i servizi in un colpo
sudo systemctl status nginx casamia-api kiwix
2
Riavvia tutto
sudo systemctl restart nginx casamia-api
3
Controlla lo spazio disco (SD piena = crash)
df -h /
4
Controlla i log di nginx
sudo tail -30 /var/log/nginx/error.log
5
Se tutto fallisce — riavvia il Pi5
sudo reboot
Alimentazione di emergenza
Consumo Pi5
5–10 W
In idle ~5W, sotto carico fino a 10W. Connettore USB-C, 5V 5A.
Powerbank 20.000 mAh
~10–15 ore
Con uscita USB-C PD 25W+. Scegli powerbank che non si spenga con carichi bassi.
Pannello solare
20–30 W
Con controller USB-C PD. In pieno sole può alimentare il Pi5 direttamente senza batteria.
Temperatura operativa
—
Case passivo in metallo aderente ai dissipatori di rame — ottimo raffreddamento senza ventole, nessun rumore, nessun pezzo mobile. Throttling automatico sopra 80°C. Tenerlo all'ombra in estate.
Backup periodico
I dati critici sono in /home/stefano/casamia-api/ (utenti, bollettino) e /var/lib/kiwix/ (Wikipedia). Per un backup rapido della configurazione:
tar -czf ~/backup-ark-$(date +%Y%m%d).tar.gz ~/casamia-api/ /etc/nginx/ /etc/systemd/system/kiwix.service
✓ Copiato