Uptime Kuma - Przewodnik na start
Uptime Kuma to narzędzie do monitorowania dostępności usług, które możesz hostować samodzielnie. Pozwala monitorować strony internetowe, interfejsy API, serwery DNS i wiele innych usług za pomocą przejrzystego panelu oraz natychmiastowych powiadomień. Ten serwer zawiera już zainstalowane i skonfigurowane Uptime Kuma, Nginx oraz PM2 – wystarczy otworzyć interfejs webowy i utworzyć konto administratora.
Krok 1 – Sprawdzenie działania Uptime Kuma
Adres IP serwera oraz hasło użytkownika root znajdziesz w sekcji Server Information na karcie Overview w panelu klienta. Otwórz w przeglądarce:
http://your.server.ipPrzy pierwszym uruchomieniu Uptime Kuma wyświetli formularz rejestracji. Wybierz nazwę użytkownika oraz hasło, a następnie kliknij Create.
Jeżeli serwer znajduje się za routerem VyOS w sieci prywatnej, skonfiguruj przekierowanie portów 80 (HTTP) i 443 (HTTPS), aby uzyskać dostęp z Internetu, lub połącz się przez VPN i korzystaj z prywatnego adresu IP serwera.
Krok 2 – Dodaj pierwszy monitor
Po zalogowaniu kliknij Add New Monitor na panelu głównym:
- Monitor Type – HTTP(s), TCP, Ping, DNS i wiele innych
- Friendly Name – opisowa nazwa monitora
- URL / Hostname – adres monitorowanej usługi
- Heartbeat Interval – częstotliwość sprawdzania (domyślnie: 60 sekund)
Kliknij Save, aby natychmiast rozpocząć monitorowanie. Powiadomienia (e-mail, Telegram, Slack, Discord i wiele innych) możesz skonfigurować w Settings > Notifications.
Krok 3 – Konfiguracja domeny i SSL (opcjonalnie)
Aby korzystać z Uptime Kuma pod własną domeną z HTTPS, utwórz rekord DNS typu A wskazujący na adres IP serwera. Następnie połącz się przez SSH i wykonaj:
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.comCertbot skonfiguruje certyfikat SSL oraz automatyczne odnawianie. Panel będzie dostępny pod adresem https://your-domain.com.
Po instalacji
Fail2Ban – Ochrona przed atakami brute-force
Na serwerze jest już skonfigurowany Fail2Ban, który chroni usługę SSH przed atakami brute-force.
| Reguła | Maksymalna liczba prób | Czas blokady |
|---|---|---|
| SSH | 5 nieudanych logowań | 10 minut |
Przydatne polecenia:
# Sprawdzenie zablokowanych adresów IP fail2ban-client status sshd # Odblokowanie adresu IP fail2ban-client set sshd unbanip 1.2.3.4Jeżeli przypadkowo zablokujesz własny adres IP, połącz się z serwerem przez konsolę VNC w panelu klienta i odblokuj swój adres.
Zarządzanie usługą
Uptime Kuma działa pod kontrolą PM2, który automatycznie restartuje aplikację po awarii lub ponownym uruchomieniu serwera.
# Sprawdzenie statusu pm2 list # Podgląd logów pm2 logs uptime-kuma # Restart pm2 restart uptime-kuma # Reverse proxy Nginx systemctl status nginx systemctl reload nginxKopie zapasowe
Wszystkie dane (monitory, powiadomienia oraz historia statusów) są przechowywane w bazie SQLite. Kopię zapasową możesz utworzyć z poziomu interfejsu (Settings > Backup) lub przez SSH:
cp -r /opt/uptime-kuma/data /root/uptime-kuma-backup-$(date +%F)Aktualizacje
# Aktualizacja 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 # Aktualizacja pakietów systemowych apt update && apt upgrade -yDołączone oprogramowanie
| Komponent | Wersja |
|---|---|
| Ubuntu | 24.04 LTS |
| Uptime Kuma | 2.x |
| Node.js | 22.x LTS |
| PM2 | 6.x |
| Nginx | 1.24 |
| Fail2Ban | 1.0.2 |
Rozwiązywanie problemów
| Problem | Rozwiązanie |
|---|---|
| Interfejs webowy nie otwiera się | Sprawdź status: pm2 list. W razie potrzeby uruchom ponownie: pm2 restart uptime-kuma. |
| Błąd 502 Bad Gateway | Uptime Kuma może nie działać na porcie 3001. Sprawdź logi: pm2 logs uptime-kuma. |
| Powiadomienia nie są wysyłane | Przejdź do Settings > Notifications i użyj przycisku Test, aby sprawdzić konfigurację kanału powiadomień. |
| Wysokie zużycie pamięci | Zwiększ interwał monitorowania lub usuń starszą historię statusów w Settings > General. |
| Zapomniane hasło administratora | Połącz się przez SSH i wykonaj: cd /opt/uptime-kuma && npm run reset-password. |
| Adres IP został zablokowany przez Fail2Ban | Połącz się z serwerem przez konsolę VNC w panelu klienta i odblokuj swój adres IP. |
| Zapomniane hasło użytkownika root | Użyj konsoli VNC dostępnej w panelu klienta, aby zresetować hasło. |