Table of Contents

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.ip

Przy pierwszym uruchomieniu Uptime Kuma wyświetli formularz rejestracji. Wybierz nazwę użytkownika oraz hasło, a następnie kliknij Create.

Ważne: Pierwsza osoba, która otworzy interfejs webowy, utworzy konto administratora. Wykonaj ten krok od razu po wdrożeniu serwera.

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.com

Certbot 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
SSH5 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.4

Jeż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 nginx

Kopie 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 -y

Dołączone oprogramowanie

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