Table of Contents

Uptime Kuma - průvodce pro začátečníky

Uptime Kuma je self-hosted monitorovací nástroj, který sleduje dostupnost vašich webů, API, DNS a dalších služeb s přehlednou nástěnkou a okamžitými oznámeními. Server obsahuje předinstalované Uptime Kuma, Nginx a PM2 – stačí otevřít webové rozhraní a vytvořit účet administrátora.


Krok 1 – Ověřte, že Uptime Kuma funguje

IP adresa a heslo root vašeho serveru jsou uvedeny na stránce Server Details v klientském panelu. Otevřete prohlížeč a přejděte na:

http://your.server.ip

Při prvním přístupu zobrazí Uptime Kuma registrační formulář. Zvolte uživatelské jméno a hesloa klikněte na Create.

Důležité: Účet administrátora vytvoří první člověk, který otevře webové rozhraní. Tento krok proveďte ihned po zřízení serveru.

Pokud jste server umístili za router VyOS v privátní síti, buď nastavte přesměrování portů (80 a 443) pro přístup k Uptime Kuma z internetu, nebo se připojte přes VPN a přistupujte přes privátní IP serveru.


Krok 2 – Přidání prvního monitoru

Po přihlášení klikněte na nástěnce na Add New Monitor :

  • Monitor Type – HTTP(s), TCP, Ping, DNS a další
  • Friendly Name – popisný název monitoru
  • URL / Hostname – cíl, který se má sledovat
  • Heartbeat Interval – jak často kontrolovat (výchozí: 60 sekund)

Klikněte na Uložit a monitorování se okamžitě spustí. Oznámení (e-mail, Telegram, Slack, Discord a mnoho dalších) přidáte v Settings > Notifications.


Krok 3 – Nastavení domény a SSL (volitelné)

Chcete-li k Uptime Kuma přistupovat přes doménu s HTTPS, vytvořte DNS A záznam směřující vaši doménu na IP serveru. Pak se připojte přes SSH a spusťte:

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 automatickou obnovu. Nástěnka bude dostupná na https://your-domain.com.


Po instalaci

Fail2Ban – ochrana proti útokům hrubou silou

Váš server obsahuje Fail2Ban předkonfigurovaný k ochraně SSH proti útokům hrubou silou.

Pravidlo Max. počet pokusů Doba blokace
SSH5 neúspěšných přihlášení10 minut

Užitečné příkazy:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Pokud se omylem zablokujete, připojte se přes konzoli VNC v klientském panelu a odblokujte svou IP.

Správa služeb

Uptime Kuma běží pod PM2, který ji udržuje v chodu a automaticky restartuje po pádu nebo restartu.

# 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šechna data (monitory, oznámení, historie stavů) jsou uložena v SQLite. Export/import můžete provést ve webovém rozhraní (Settings > Backup) nebo zálohovat přes SSH:

cp -r /opt/uptime-kuma/data /root/uptime-kuma-backup-$(date +%F)

Aktualizace

# 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ý software

Komponenta Verze
Ubuntu24.04 LTS
Uptime Kuma2.x
Node.js22.x LTS
PM26.x
Nginx1.24
Fail2Ban1.0.2

Řešení problémů

Problém Řešení
Webové rozhraní se nenačítá Kontrola stavu: pm2 list. V případě potřeby restartujte: pm2 restart uptime-kuma
502 Bad Gateway Uptime Kuma možná neběží na portu 3001. Kontrola logů: pm2 logs uptime-kuma
Oznámení se neodesílají Přejděte na Settings > Notifications a pomocí tlačítka Test ověřte kanál oznámení
Vysoké využití paměti Zvyšte interval heartbeat nebo vymažte starou historii stavů v Settings > General
Zapomenuté heslo administrátora Připojte se přes SSH a resetujte: cd /opt/uptime-kuma && npm run reset-password
Blokováno službou Fail2Ban Odblokujte svou IP přes konzoli VNC v klientském panelu
Zapomenuté heslo root Obnovte jej přes konzoli VNC v klientském panelu