Uptime Kuma: rendelkezésre állás figyelése a saját szervereden
Saját üzemeltetésű figyelő, amely percenként ellenőrzi az oldalaidat és szolgáltatásaidat, és azonnal szól, ha valamelyik nem válaszol.
A(z) Uptime Kuma bemutatása
Az Uptime Kuma nyílt forráskódú monitorozóeszköz, amelyet Louis Lam fejlesztő indított el, és ma a GitHub egyik legtöbb csillagot kapott, saját üzemeltetésű projektje. Azt ellenőrzi, hogy a dolgok válaszolnak-e: weboldalak HTTP(S)-en, kulcsszavak egy oldalon, TCP-portok, ping, DNS-rekordok, adatbázisok és még sok más.
Ha egy ellenőrzés sikertelen, értesítést küld a több tucat támogatott csatorna egyikén, például Telegramon, Discordon, Slacken, e-mailben vagy webhookon. Méri a válaszidőket is, figyelmeztet a TLS-tanúsítványok lejárata előtt, és nyilvános állapotoldalakat is készíthetsz vele az ügyfeleidnek.
Azért üzemeltetik sokan maguk, mert könnyű, ingyenes, és letisztult felülete percek alatt beállítható. A kulcs az, hogy külön szerveren fusson: egy figyelő, amely ugyanazon a gépen van, mint az oldalad, nem tud szólni, ha az a gép leáll.
Mire használják
Riasztás, ha leáll egy oldal
Ellenőrizd percenként a weboldaladat és az API-dat, és kapj Telegram-üzenetet vagy e-mailt, amint nem válaszolnak.
Figyelmeztetés tanúsítványlejárat előtt
Kapj emlékeztetőt napokkal azelőtt, hogy egy HTTPS-tanúsítvány lejár, ne az ügyfeleidtől halld.
Nyilvános állapotoldal
Mutasd meg az ügyfeleidnek a szolgáltatásaid aktuális állapotát egy általad kezelt oldalon.
A rendelés után
A szerver első indítása telepíti az Uptime Kumát, és megnyitja a 3001-es portot a tűzfalban, így a figyelő a http://szerver-cime:3001/ címen érhető el. Az első látogatáskor hozod létre a rendszergazdai fiókot, ezért nyisd meg a címet, amint a szerver elkészült. Ezután add hozzá az első figyelődet, és kapcsolj be egy értesítési csatornát.
Hol futtasd
Az Uptime Kuma onnan ellenőriz, ahol fut. Ha ugyanazon a szerveren van, mint a figyelt szolgáltatások, velük együtt áll le, és nem tud figyelmeztetni, ezért tartsd külön szerveren attól, amit figyel.
Saját domain és HTTPS az Uptime Kumához
Alapból az Uptime Kuma a szerver IP-címén, sima HTTP-n válaszol. Ha olyan nevet szeretnél neki tanúsítvánnyal, mint a status.cegnev.hu, hozz létre a DNS-ben egy A rekordot erre a névre, amely a szerver IPv4-címére mutat, majd tedd elé a Caddyt: a Caddy magától szerez ingyenes Let's Encrypt-tanúsítványt, és meg is újítja. Az alábbi parancsok az alkalmazásszervereinken futó Ubuntu 24.04-hez valók.
A panelben nyisd meg a 80-as és a 443-as TCP-portot a szerver tűzfalán: ezekre a Caddynek a Let's Encrypt-tanúsítvány megszerzéséhez és az oldal kiszolgálásához van szüksége.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyHa domain áll előtte, az Uptime Kuma állapotoldalait megoszthatod az ügyfeleiddel: hozz létre egy állapotoldalt, válaszd ki, mely figyelőket mutassa, és add ki a https://status.cegnev.hu/status/oldalad címet. A domaint magához az állapotoldalhoz is hozzárendelheted annak beállításaiban.
Ha a domain működik, a nyers 3001-es portra már senkinek nincs szüksége: az /opt/uptime-kuma/compose.yml fájlban írd át a "3001:…" részt erre: "127.0.0.1:3001:…", futtasd a docker compose up -d parancsot, és töröld a 3001-es portot a tűzfalból. Ezután az Uptime Kuma csak HTTPS-en érhető el.
Az Uptime Kuma frissítése
Az /opt/uptime-kuma/compose.yml fájlban az image-ek pontos verzióhoz vannak rögzítve, így egy sima docker compose pull ugyanazt a verziót tölti le újra. Frissítéshez írd át az image: sorban a verziót a kívántra (előbb olvasd el a kiadási megjegyzéseket), majd töltsd le és hozd létre újra a konténereket. Az adatok Docker-kötetekben vannak, és megmaradnak.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dAz Uptime Kuma biztonsági mentése
A panelben bekapcsolhatod a teljes szerver napi biztonsági mentését (a csomag árának +20%-a, az utolsó 7 példány marad meg), és bármelyikből visszaállíthatod a szervert. Ettől függetlenül érdemes az alkalmazás saját adatairól is fájlba mentést készíteni: ez átvihető egy másik szerverre, vagy visszaállítható anélkül, hogy minden mást is visszaállítanál.
A figyelők, az értesítési beállítások és az ellenőrzések előzményei az uptime-kuma_uptime_kuma kötetben (/app/data) vannak. Állítsd le egy pillanatra az alkalmazást, hogy az adatbázisfájl konzisztens állapotban másolódjon:
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 startHogyan működik
- A szerverrendelési oldalon válaszd a(z) Uptime Kuma alkalmazást, és egy elegendő memóriájú csomagot.
- Az alkalmazás a szerver első indításakor települ, általában néhány perc alatt.
- Nyisd meg a szervert a panelben: ott találod a címet és a belépési adatokat.