Uptime Kuma hosztolása Managed VPS-en: figyelje szolgáltatásait folyamatosan

Mit figyel az Uptime Kuma

Az Uptime Kuma rendszeres időközönként, akár 20 másodpercenként lekérdezi a szolgáltatásait, megőrzi a válaszaik előzményeit, és értesíti, amint valamelyik nem válaszol. Webes felületről használható, amely több nyelven elérhető.

• A monitorok: HTTP és HTTPS, kulcsszó keresése az oldalon, JSON-lekérdezés, TCP, WebSocket, ping, DNS-rekord, Docker-konténerek, valamint „push” típusú monitor az ütemezett feladatokhoz, amelyek maguk jelzik a lefutásukat.
• A riasztások: több mint 90 értesítési szolgáltatás, köztük a Telegram, a Discord, a Slack és az e-mail.
• Az állapotoldalak: több nyilvános oldal, kívánság szerint mindegyik a saját domainjén.
• A tanúsítványok: az egyes figyelt szolgáltatások HTTPS-tanúsítványának adatai.
• A fiók: kétlépcsős hitelesítés, és proxyn keresztüli kapcsolat azoknak a monitoroknak, amelyeknek erre szükségük van.

Helyezze az Uptime Kumát a figyelt szolgáltatásoktól eltérő szerverre. Különálló gépen a hibát kívülről látja, és akkor küldi el a riasztást, amikor a szolgáltatásai le vannak állva.

Mit enged meg az MIT licenc

Az Uptime Kuma MIT licenc alatt jelenik meg. Engedélyezi a szoftver használatát, másolását, módosítását, egyesítését, közzétételét, terjesztését, allicencelését és eladását, egyetlen feltétellel: a szerzői jogi megjelölést és a licenc szövegét meg kell tartani minden másolatban.

Az Uptime Kumát tehát futtathatja a vállalkozásában, figyelheti vele az ügyfelei szolgáltatásait, és állapotoldalakat nyithat nekik, licenc vásárlása nélkül.

Telepítés Docker Compose-zal

Az Uptime Kuma dokumentációja a Docker Compose-zal kezdődik. Egy olyan szerveren, ahol a Docker telepítve van, hozzon létre egy mappát, és töltse le a hivatalos fájlt:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

A projekt fájlja a 3001-es portot a szerver minden címén közzéteszi. Fordított proxy mögött korlátozza a helyi címre, ahogyan a README javasolja:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

• A 127.0.0.1 címen közzétett port: a Docker alapértelmezésként a szerver minden címén közzéteszi a portot, az ufw tűzfal szabályai előtt. Helyben közzétéve az Uptime Kuma csak a fordított proxyn keresztül érhető el.
• Egy data mappa helyi lemezen: ez őrzi a kuma.db adatbázist, a feltöltött fájlokat és a képernyőképeket. A projekt kizárja az NFS-t és a többi hálózati fájlrendszert, mert az SQLite-nak megbízható fájlzárolásra van szüksége.
• A 2 címke az Uptime Kuma 2-es verzióját követi, a következő főverzióra való áttérés pedig az Ön döntése marad.
• A 2-slim image könnyebb, letöltése nagyjából 185 MB a 620 MB-tal szemben: nem tartalmazza a Chromiumot és a beépített MariaDB-t, amelyet a 2 image hordoz. A projekt a 2 image-et ajánlja, és a „Browser Engine” monitorhoz a 2-slim mellett külső Chromium kell.

Az első indításkor nyissa meg a felületet: egy varázsló végigvezeti az adatbázis kiválasztásán, majd a rendszergazdai fiók létrehozásán. Kapcsolja be a kétlépcsős hitelesítést már az első bejelentkezéskor.

A projekt nem ad meg memória- és processzorigényt: a méret a figyelendő szolgáltatások számától és a kívánt gyakoriságtól függ. Egy Managed VPS esetén írja le nekünk a használatát, és mi azt a méretet javasoljuk, amely megfelel.

HTTPS és WebSocket: a fordított proxy

Nyilvános hálózaton a projekt HTTPS-t kér. Az Uptime Kuma a WebSocketre épül: a fordított proxynak át kell adnia az Upgrade és a Connection fejlécet. Egy domain vagy aldomain gyökerében szolgálja ki, a wikije pedig kizárja az olyan almappákat, mint az example.com/uptimekuma.

Caddyvel

A Caddy maga szerzi meg és újítja meg a tanúsítványt, és külön beállítás nélkül átadja a WebSocketet:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Nginxszel és Certbottal

server {
    listen 80;
    server_name uptime.example.com;

    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
    }
}

A Certbot ezután telepíti a Let's Encrypt-tanúsítványt és a HTTPS-re irányító átirányítást, majd magától megújítja a tanúsítványt:

sudo certbot --nginx -d uptime.example.com

Ha az Uptime Kuma csak a proxyn keresztül érhető el, nyissa meg a beállításait: „Settings”, „Reverse Proxy”, „HTTP Headers”, és állítsa a „Trust Proxy” értékét „Yes”-re: a naplók ekkor a látogatók valódi címét mutatják.

SQLite vagy MariaDB

A 2-es verziótól az Uptime Kuma három adatbázist kínál, amelyek közül az első indítás varázslója segítségével lehet választani:

Ha előre szeretné rögzíteni a választást, a varázsló nélkül, az UPTIME_KUMA_DB_TYPE, az UPTIME_KUMA_DB_HOSTNAME, az UPTIME_KUMA_DB_PORT, az UPTIME_KUMA_DB_NAME, az UPTIME_KUMA_DB_USERNAME és az UPTIME_KUMA_DB_PASSWORD változót adja hozzá a szolgáltatáshoz a compose.yaml fájlban.

Az értesítések, az e-mailt is beleértve

Egy monitor csak akkor ér valamit, ha a riasztás eljut Önhöz. Adja meg a csatornáit a „Settings”, „Notifications” menüben, küldjön mindegyikről próbaüzenetet, és állítson be kettőt, például egy üzenetküldőt és az e-mailt: ha az egyik kiesik, a másik átveszi a feladatát.

Az e-mailhez az Uptime Kuma egy SMTP-szerverhez csatlakozik. Simafri VPS-en a küldés egy hitelesített továbbítón keresztül megy, a 587-es porton: egy meglévő levelezési fiók címével, vagy a Simafri Suite-tal.

Mentések és frissítések

A 2-es verziótól a data mappa mentése az egyetlen módszer, amelyet a projekt támogat. SQLite-tal vagy a beépített MariaDB-vel minden benne van. Az írás közben lemásolt SQLite-adatbázis megsérülhet: a másolás idejére állítsa le a konténert, tudva, hogy vele együtt a monitorok is leállnak.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Frissítés

A projekt wikije két parancsot ad meg, a compose.yaml mappájából. A data mappa a helyén marad:

docker compose pull
docker compose up -d --force-recreate

Minden frissítés előtt olvassa el a kiadási megjegyzéseket: némelyik biztonsági javításokat tartalmaz, mint a 2026. október 31-i 2.5.9-es. A közvetlenül előtte készített mentés egyszerű visszalépést biztosít.

Az 1-es verzióról a 2-esre való áttérés nagyobb gondosságot kíván: mentse a data mappát leállított konténerrel, és hagyja, hogy az átállás a végéig lefusson, mert egy megszakított átállás után vissza kell állítani a mentést. A projekt mérése szerint körülbelül 7 percig tart 20 monitor és 90 napnyi előzmény esetén, egy szerény gépen vagy több monitorral pedig jóval tovább.

Ki mit csinál egy Managed VPS-en

A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; az Uptime Kuma továbbra is az Ön szoftvere marad, a beállításaival és az adataival.

Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.