Uptime Kuma - príručka pre začiatočníkov
Uptime Kuma je self-hosted monitorovací nástroj, ktorý sleduje dostupnosť vašich webov, API, DNS a ďalších služieb s prehľadnou nástenkou a okamžitými oznámeniami. Server obsahuje predinštalované Uptime Kuma, Nginx a PM2 – stačí otvoriť webové rozhranie a vytvoriť účet administrátora.
Krok 1 – Overte, že Uptime Kuma funguje
IP adresa a heslo root vášho servera sú uvedené na stránke Server Details v klientskom paneli. Otvorte prehliadač a prejdite na:
http://your.server.ip
Pri prvom prístupe zobrazí Uptime Kuma registračný formulár. Zvoľte používateľské meno a hesloa kliknite na Create.
Ak ste server umiestnili za router VyOS v privátnej sieti, buď nastavte presmerovanie portov (80 a 443) na prístup k Uptime Kuma z internetu, alebo sa pripojte cez VPN a pristupujte cez privátnu IP servera.
Krok 2 – Pridanie prvého monitora
Po prihlásení kliknite na nástenke na Add New Monitor :
- Monitor Type – HTTP(s), TCP, Ping, DNS a ďalšie
- Friendly Name – popisný názov monitora
- URL / Hostname – cieľ, ktorý sa má sledovať
- Heartbeat Interval – ako často kontrolovať (predvolené: 60 sekúnd)
Kliknite na Uložiť a monitorovanie sa okamžite spustí. Oznámenia (e-mail, Telegram, Slack, Discord a mnoho ďalších) pridáte v Settings > Notifications.
Krok 3 – Nastavenie domény a SSL (voliteľné)
Ak chcete k Uptime Kuma pristupovať cez doménu s HTTPS, vytvorte DNS A záznam smerujúci vašu doménu na IP servera. Potom sa pripojte cez SSH a spustite:
ssh root@your.server.ip
sed -i 's/server_name _;/server_name your-domain.com;/' /etc/nginx/sites-available/uptime-kuma
nginx -t && systemctl reload nginx
apt install -y certbot python3-certbot-nginx
certbot --nginx -d your-domain.com
Certbot nastaví SSL a automatickú obnovu. Nástenka bude dostupná na https://your-domain.com.
Po inštalácii
Fail2Ban – ochrana proti útokom hrubou silou
Váš server obsahuje Fail2Ban predkonfigurovaný na ochranu SSH proti útokom hrubou silou.
| Pravidlo | Max. počet pokusov | Doba blokovania |
|---|---|---|
| SSH | 5 neúspešných prihlásení | 10 minút |
Užitočné príkazy:
# Check banned IPs
fail2ban-client status sshd
# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4
Ak sa omylom zablokujete, pripojte sa cez konzolu VNC v klientskom paneli a odblokujte svoju IP.
Správa služieb
Uptime Kuma beží pod PM2, ktorý ju udržiava v chode a automaticky reštartuje po páde alebo reštarte.
# Check status
pm2 list
# View logs
pm2 logs uptime-kuma
# Restart
pm2 restart uptime-kuma
# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx
Zálohy
Všetky dáta (monitory, oznámenia, história stavov) sú uložené v SQLite. Export/import môžete vykonať vo webovom rozhraní (Settings > Backup) alebo zálohovať cez SSH:
cp -r /opt/uptime-kuma/data /root/uptime-kuma-backup-$(date +%F)
Aktualizácie
# Update Uptime Kuma
cd /opt/uptime-kuma
pm2 stop uptime-kuma
git fetch --all
git checkout $(git describe --tags --abbrev=0 origin/master)
npm install --production
npm run download-dist
pm2 restart uptime-kuma
pm2 save
# Update OS packages
apt update && apt upgrade -y
Zahrnutý softvér
| Komponent | Verzia |
|---|---|
| Ubuntu | 24.04 LTS |
| Uptime Kuma | 2.x |
| Node.js | 22.x LTS |
| PM2 | 6.x |
| Nginx | 1.24 |
| Fail2Ban | 1.0.2 |
Riešenie problémov
| Problém | Riešenie |
|---|---|
| Webové rozhranie sa nenačítava | Kontrola stavu: pm2 list. V prípade potreby reštartujte: pm2 restart uptime-kuma |
| 502 Bad Gateway | Uptime Kuma možno nebeží na porte 3001. Kontrola logov: pm2 logs uptime-kuma |
| Oznámenia sa neodosielajú | Prejdite na Settings > Notifications a pomocou tlačidla Test overte kanál oznámení |
| Vysoké využitie pamäte | Zvýšte interval heartbeat alebo vymažte starú históriu stavov v Settings > General |
| Zabudnuté heslo administrátora | Pripojte sa cez SSH a resetujte: cd /opt/uptime-kuma && npm run reset-password |
| Zablokované službou Fail2Ban | Odblokujte svoju IP cez konzolu VNC v klientskom paneli |
| Zabudnuté heslo root | Obnovte ho cez konzolu VNC v klientskom paneli |