Zacznij
Wszystkie aplikacje na VPS
Monitoring

Uptime Kuma: monitoring dostępności na twoim serwerze

Monitoring na własnym serwerze, który co minutę sprawdza twoje strony i usługi i daje znać w chwili, gdy któraś z nich przestaje odpowiadać.

Zamów serwer z Uptime Kuma Zobacz pakiety VPS

O aplikacji Uptime Kuma

Uptime Kuma to otwartoźródłowe narzędzie do monitoringu, zapoczątkowane przez programistę Louisa Lama, a dziś jeden z najczęściej oznaczanych gwiazdką projektów do samodzielnego hostowania na GitHubie. Sprawdza, czy coś odpowiada: strony przez HTTP(S), słowa kluczowe na stronie, porty TCP, ping, rekordy DNS, bazy danych i wiele więcej.

Gdy sprawdzenie się nie powiedzie, wysyła powiadomienie jednym z kilkudziesięciu obsługiwanych kanałów, m.in. przez Telegram, Discord, Slack, e-mail i webhooki. Śledzi też czasy odpowiedzi, ostrzega przed wygaśnięciem certyfikatów TLS i pozwala budować publiczne strony statusu dla klientów.

Ludzie hostują go u siebie, bo jest lekki, darmowy i ma przejrzysty interfejs, który konfiguruje się w kilka minut. Kluczowy szczegół to osobny serwer: monitoring działający na tej samej maszynie co twoja strona nie powie ci, że ta maszyna padła.

Do czego się przydaje

Alerty, gdy strona przestaje działać

Sprawdzaj stronę i API co minutę i dostawaj wiadomość na Telegramie albo e-mail, gdy tylko przestaną odpowiadać.

Ostrzeżenia o wygasających certyfikatach

Dostań przypomnienie kilka dni przed wygaśnięciem certyfikatu HTTPS, zamiast dowiadywać się o tym od klientów.

Publiczna strona statusu

Pokazuj klientom bieżący stan swoich usług na stronie, nad którą masz kontrolę.

Po zamówieniu

Przy pierwszym uruchomieniu serwera instaluje się Uptime Kuma i otwiera się port 3001 w firewallu, więc monitoring jest dostępny pod adresem http://adres-twojego-serwera:3001/. Przy pierwszej wizycie tworzysz konto administratora, więc otwórz adres, gdy tylko serwer będzie gotowy. Potem dodaj pierwszy monitor i podłącz kanał powiadomień.

Gdzie go uruchomić

Uptime Kuma sprawdza usługi z miejsca, w którym działa. Monitoring na tym samym serwerze co pilnowane usługi pada razem z nimi i nie może cię ostrzec, więc trzymaj go na innym serwerze niż to, co monitoruje.

Własna domena i HTTPS dla Uptime Kuma

Po instalacji Uptime Kuma odpowiada na adresie IP serwera przez zwykłe HTTP. Żeby nadać mu nazwę, na przykład status.example.com, z certyfikatem, utwórz w swoim DNS rekord A dla tej nazwy wskazujący na adres IPv4 serwera, a potem postaw przed nim Caddy: Caddy sam uzyskuje darmowy certyfikat Let's Encrypt i go odnawia. Poniższe polecenia są dla Ubuntu 24.04, na którym działają nasze serwery aplikacji.

W panelu otwórz porty TCP 80 i 443 w firewallu serwera: Caddy potrzebuje ich, żeby uzyskać certyfikat Let's Encrypt i serwować stronę.

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
    reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddy

Z domeną strony statusu Uptime Kuma można udostępniać klientom: utwórz stronę statusu, wybierz, które monitory ma pokazywać, i podaj adres https://status.example.com/status/twoja-strona. Domenę możesz też przypisać bezpośrednio do strony statusu w jej ustawieniach.

Gdy domena działa, nikt już nie potrzebuje gołego portu 3001: w /opt/uptime-kuma/compose.yml zmień "3001:…" na "127.0.0.1:3001:…", uruchom docker compose up -d i usuń port 3001 z firewalla. Wtedy Uptime Kuma jest dostępny wyłącznie przez HTTPS.

Aktualizacja Uptime Kuma

Obrazy w /opt/uptime-kuma/compose.yml są przypięte do konkretnych wersji, więc samo docker compose pull pobierze ponownie tę samą wersję. Żeby zaktualizować, zmień wersję w linii image: na wybraną (najpierw przeczytaj informacje o wydaniu), a potem pobierz obrazy i utwórz kontenery od nowa. Dane są w wolumenach Dockera i zostają.

cd /opt/uptime-kuma
nano compose.yml        # the new version in the image: line
docker compose pull
docker compose up -d

Kopia zapasowa Uptime Kuma

W panelu możesz włączyć codzienne kopie zapasowe całego serwera (+20% ceny pakietu, przechowywane są ostatnie 7 kopii) i przywrócić serwer z dowolnej z nich. Mimo to warto mieć kopię danych samej aplikacji w pliku: można ją przenieść na inny serwer albo przywrócić bez cofania wszystkiego innego.

Monitory, ustawienia powiadomień i historia sprawdzeń są w wolumenie uptime-kuma_uptime_kuma (/app/data). Zatrzymaj na chwilę aplikację, żeby plik bazy danych został skopiowany w spójnym stanie:

cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
  tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start

Jak to działa

  1. Wybierz Uptime Kuma na stronie zamówienia serwera i pakiet z wystarczającą ilością pamięci.
  2. Aplikacja instaluje się na serwerze przy pierwszym uruchomieniu, zwykle w ciągu kilku minut.
  3. Otwórz serwer w panelu: znajdziesz tam adres i dane logowania.

Pytania o Uptime Kuma

Tak. Uptime Kuma jest lekki: minimum to 1 GB pamięci RAM i 20 GB dysku, co spokojnie obsłuży kilkadziesiąt monitorów. Setki monitorów z krótkimi odstępami lepiej działają na 2 GB.
Lepiej nie. Jeśli dzielą serwer i ten serwer padnie, monitoring też przestanie działać i żaden alert nie zostanie wysłany. Niezawodne rozwiązanie to mały osobny serwer.
Tak. Mały pakiet ARM pasuje do niego tak samo dobrze jak x86.
Przez kanały powiadomień skonfigurowane w Uptime Kuma: Telegram, e-mail przez SMTP, Slack, Discord, webhooki i wiele innych. Dodaj kanał raz i przypisz go do monitorów.
Pierwsza osoba, która otworzy adres, tworzy konto administratora, więc otwórz http://adres-twojego-serwera:3001/, gdy tylko serwer będzie gotowy.

Inne aplikacje w kategorii Monitoring