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.
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 |
|---|---|---|
| SSH | 5 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Uptime Kuma | 2.x |
| Node.js | 22.x LTS |
| PM2 | 6.x |
| Nginx | 1.24 |
| Fail2Ban | 1.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 |