O Uptime Kuma
Uptime Kuma to samodzielnie hostowane narzędzie do monitoringu, rozwijane przez Louisa Lama i społeczność na licencji MIT. W regularnych odstępach odpytuje strony internetowe, API, porty TCP, hosty (ping), rekordy DNS i kontenery Docker. Gdy coś przestaje odpowiadać, wysyła powiadomienie przez Telegram, Discord, Slack, e-mail lub webhook. Interfejs jest czytelny i nie wymaga czytania dokumentacji.
Narzędzie jest dla programistów, agencji i małych zespołów, które chcą dowiedzieć się o awarii wcześniej niż ich klienci, bez płacenia abonamentu SaaS za każdy monitor. Własny VPS daje też pełną kontrolę nad danymi z monitoringu.
Po dostarczeniu na serwerze znajdziesz Dockera, Uptime Kuma (obraz louislam/uptime-kuma:2) i reverse proxy Caddy. Aplikacja nasłuchuje wyłącznie na 127.0.0.1:3001, a Caddy udostępnia ją przez HTTPS na porcie 443 publicznego adresu IP serwera, z certyfikatem samopodpisanym. Zostaje otworzyć adres URL i utworzyć konto administratora.
Co możesz zrobić z Uptime Kuma
Wiele typów monitorów
HTTP(S), słowo kluczowe na stronie, TCP, ping, DNS, kontener Docker i inne. Sam ustawiasz interwał sprawdzania i liczbę nieudanych prób przed wysłaniem alertu.
Alerty w Twoich kanałach
Telegram, Discord, Slack, e-mail SMTP, webhook i wiele innych usług powiadomień jest dostępnych w interfejsie, bez instalowania wtyczek.
Publiczne strony statusu
Publikujesz stronę ze stanem usług dla klientów lub zespołu, w razie potrzeby pod własną domeną.
Kontrola certyfikatów TLS
Uptime Kuma odczytuje datę wygaśnięcia certyfikatów monitorowanych stron HTTPS i może ostrzec Cię, zanim certyfikat straci ważność.
Docker i Caddy gotowe
Dwa kontenery z automatycznym restartem (
restart: always), opisane w plikudocker-compose.yml, który możesz edytować i wersjonować.Dane w osobnym wolumenie
Konfiguracja i historia monitorów są przechowywane w wolumenie Docker
kuma_data, co upraszcza kopie zapasowe i aktualizacje.
Pierwsze kroki z Uptime Kuma
Od zamówienia do produkcji w kilka minut.
- 1
Zamów VPS z Uptime Kuma
W formularzu zamówienia wybierz VPS z Linuksem (Paryż lub Frankfurt) z Debianem 12, Debianem 13 albo Ubuntu 20.04, 22.04, 24.04. Na karcie „Aplikacje” zaznacz Uptime Kuma.
- 2
Poczekaj na dostawę i otwórz interfejs
Po dostarczeniu serwera instalacja trwa w tle kilka minut (pobieranie Dockera i obrazów). Następnie otwórz poniższy adres. Przeglądarka pokaże ostrzeżenie, bo certyfikat jest samopodpisany: zaakceptuj wyjątek, aby przejść dalej.
Bashhttps://SERVER_IP:443 # Sprawdzenie stanu kontenerów przez SSH: ssh root@SERVER_IP cd /opt/uptime-kuma && docker compose ps - 3
Utwórz konto admina i pierwszy monitor
Przy pierwszym wejściu Uptime Kuma poprosi o utworzenie użytkownika administratora. Potem dodaj monitor (na przykład HTTP(S) dla Twojej strony) i skonfiguruj kanał powiadomień, aby dostawać alerty.
- 4
Zabezpiecz instalację na produkcję
Skieruj rekord DNS A domeny YOUR_DOMAIN na SERVER_IP, a potem zastąp adres w Caddyfile swoją domeną: Caddy uzyska certyfikat uznawany przez przeglądarki. Porty 80 i 443 muszą pozostać otwarte, a port 22 warto ograniczyć do Twoich adresów IP.
Bashcd /opt/uptime-kuma nano Caddyfile # YOUR_DOMAIN { # reverse_proxy 127.0.0.1:3001 # } docker compose restart caddy
Zastosowania Uptime Kuma
Monitoring stron i API
Jeden monitor HTTP na każdą stronę lub krytyczny endpoint, z alertem na Telegramie lub e-mailem, gdy kod odpowiedzi wypadnie poza oczekiwany zakres.
Strona statusu dla klientów
Agencja lub dostawca SaaS publikuje stan usług na osobnej stronie, dzięki czemu nie musi odpowiadać na każde pytanie w wiadomości.
Kontrola serwerów i portów wewnętrznych
Ping do maszyn, TCP do bazy danych lub usługi SSH, sprawdzanie kontenera Docker: jeden widok całej infrastruktury.
Ostrzeżenia o wygasaniu certyfikatów
Śledzisz daty wygaśnięcia certyfikatów swoich domen i dostajesz alert, zanim nieudane odnowienie wyłączy stronę.
Najczęstsze pytania o Uptime Kuma
Recepta konfiguruje Caddy z dyrektywą tls internal, która generuje certyfikat samopodpisany dla adresu IP serwera. Szyfrowanie działa, ale przeglądarka nie może zweryfikować wystawcy. Przypisz do serwera domenę i zmień Caddyfile, aby uzyskać uznawany certyfikat.
Więcej o Uptime Kuma
Lokalizacja plików
Wszystko znajduje się w /opt/uptime-kuma: skrypt instalacyjny install-uptime-kuma.sh, plik docker-compose.yml i Caddyfile. Caddy działa w trybie network_mode: host i czyta Caddyfile tylko do odczytu.
Nie uruchamiaj ponownie skryptu instalacyjnego po edycji Caddyfile. Skrypt nadpisuje go publicznym adresem IP i stracisz konfigurację domeny. Aby zastosować zmianę, użyj docker compose restart caddy.
Przejście z adresu IP na domenę
Domyślnie Caddyfile zawiera https://IP_PUBLIQUE:443 z dyrektywą tls internal, stąd certyfikat samopodpisany. Gdy zastąpisz tę linię nazwą domeny i usuniesz tls internal, Caddy sam zamówi i będzie odnawiać publiczny certyfikat. Rekord DNS musi już wskazywać na serwer, w przeciwnym razie żądanie się nie powiedzie.
Kopie zapasowe
Dane Uptime Kuma leżą w wolumenie Docker kuma_data. Najbezpieczniej zatrzymać kontener na czas kopiowania, a potem zarchiwizować wolumen.
Bashcd /opt/uptime-kuma docker compose stop uptime-kuma docker volume ls | grep kuma_data docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \ tar czf /backup/kuma-backup.tar.gz -C /data . docker compose start uptime-kuma
Dokładna nazwa wolumenu zależy od katalogu projektu, więc sprawdź ją poleceniem docker volume ls. Potem skopiuj archiwum poza serwer. Przydatnym uzupełnieniem jest też snapshot VPS.
Aktualizacje
Obraz używa tagu 2, który śledzi wydania 2.x. Aby pobrać najnowszą wersję, wykonaj kopię zapasową, a następnie:
Bashcd /opt/uptime-kuma docker compose pull docker compose up -d
Gdzie umieścić monitoring
Monitor działający na serwerze, który sam nadzoruje, nie powiadomi Cię, gdy cały serwer przestanie działać. Dla ważnych usług zainstaluj Uptime Kuma na osobnym VPS, na przykład w drugiej lokalizacji (Paryż lub Frankfurt). Więcej znajdziesz w naszych poradnikach.
