Table of Contents

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.

Dôležité: Účet administrátora vytvorí prvý človek, ktorý otvorí webové rozhranie. Tento krok vykonajte hneď po zriadení servera.

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
SSH5 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
Ubuntu24.04 LTS
Uptime Kuma2.x
Node.js22.x LTS
PM26.x
Nginx1.24
Fail2Ban1.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