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ć.
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 caddyZ 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 -dKopia 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 startJak to działa
- Wybierz Uptime Kuma na stronie zamówienia serwera i pakiet z wystarczającą ilością pamięci.
- Aplikacja instaluje się na serwerze przy pierwszym uruchomieniu, zwykle w ciągu kilku minut.
- Otwórz serwer w panelu: znajdziesz tam adres i dane logowania.