Uptime Kuma: monitoraggio dell'uptime sul tuo server
Un monitor self-hosted che controlla i tuoi siti e servizi ogni minuto e ti avvisa nel momento in cui uno di loro smette di rispondere.
Informazioni su Uptime Kuma
Uptime Kuma è uno strumento di monitoraggio open source avviato dallo sviluppatore Louis Lam, oggi tra i progetti self-hosted con più stelle su GitHub. Controlla che le cose rispondano: siti in HTTP(S), parole chiave in una pagina, porte TCP, ping, record DNS, database e altro.
Quando un controllo fallisce, invia una notifica tramite uno delle decine di canali supportati, tra cui Telegram, Discord, Slack, email e webhook. Tiene traccia anche dei tempi di risposta, avvisa prima che i certificati TLS scadano e permette di creare pagine di stato pubbliche per i tuoi clienti.
Lo si ospita in proprio perché è leggero, gratuito e ha un'interfaccia pulita che si configura in pochi minuti. Il dettaglio decisivo è farlo girare su un server separato: un monitor che vive sulla stessa macchina del tuo sito non può dirti quando quella macchina si ferma.
A cosa serve
Avvisi quando un sito va giù
Controlla sito e API ogni minuto e ricevi un messaggio su Telegram o un'email appena smettono di rispondere.
Avvisi di scadenza dei certificati
Ricevi un promemoria giorni prima che un certificato HTTPS scada, invece di saperlo dai clienti.
Una pagina di stato pubblica
Mostra ai clienti lo stato attuale dei tuoi servizi su una pagina che controlli tu.
Dopo l'ordine
Al primo avvio del server Uptime Kuma viene installato e la porta 3001 viene aperta nel firewall, quindi il monitor è raggiungibile su http://indirizzo-del-server:3001/. Alla prima visita crei l'account amministratore, quindi apri l'indirizzo appena il server è pronto. Poi aggiungi il primo monitor e collega un canale di notifica.
Dove farlo girare
Uptime Kuma controlla dal punto in cui gira. Un monitor sullo stesso server dei servizi che sorveglia cade insieme a loro e non può avvisarti, quindi tienilo su un server separato da ciò che monitora.
Il tuo dominio e HTTPS per Uptime Kuma
Di serie Uptime Kuma risponde sull'indirizzo IP del server in semplice HTTP. Per dargli un nome come status.example.com con un certificato, crea nel tuo DNS un record A per quel nome che punti all'indirizzo IPv4 del server, poi metti Caddy davanti: Caddy ottiene da solo un certificato Let's Encrypt gratuito e lo rinnova. I comandi qui sotto sono per Ubuntu 24.04, il sistema dei nostri server per le app.
Nel pannello apri le porte TCP 80 e 443 nel firewall del server: a Caddy servono per ottenere il certificato Let's Encrypt e per servire il sito.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyCon un dominio davanti, le pagine di stato di Uptime Kuma si possono condividere con i clienti: crea una pagina di stato, scegli quali monitor mostra e comunica l'indirizzo https://status.example.com/status/tua-pagina. Nelle impostazioni della pagina di stato puoi anche collegarle direttamente il dominio.
Quando il dominio funziona, la porta 3001 diretta non serve più a nessuno: in /opt/uptime-kuma/compose.yml cambia "3001:…" in "127.0.0.1:3001:…", esegui docker compose up -d e togli la porta 3001 dal firewall. A quel punto Uptime Kuma è raggiungibile solo in HTTPS.
Aggiornare Uptime Kuma
Le immagini in /opt/uptime-kuma/compose.yml sono fissate a versioni esatte, quindi un semplice docker compose pull riscarica la stessa versione. Per aggiornare, cambia la versione nella riga image: con quella che vuoi (prima leggi le note di rilascio), poi scarica e ricrea i container. I dati stanno nei volumi Docker e vengono conservati.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dBackup di Uptime Kuma
Nel pannello puoi attivare i backup giornalieri dell'intero server (+20% del prezzo del piano, vengono conservate le ultime 7 copie) e ripristinare il server da uno qualsiasi di essi. Avere anche una copia dei dati dell'app in un file conviene comunque: si può spostare su un altro server o ripristinare senza riportare indietro tutto il resto.
Monitor, impostazioni delle notifiche e storico dei controlli si trovano nel volume uptime-kuma_uptime_kuma (/app/data). Ferma l'app per un momento, così il file del database viene copiato in uno stato coerente:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startCome funziona
- Scegli Uptime Kuma nella pagina di ordine del server e un piano con memoria sufficiente.
- L'app viene installata sul server al primo avvio, di solito in pochi minuti.
- Apri il server nel tuo pannello: lì trovi l'indirizzo e i dati di accesso.