Checkmate hosztolása Managed VPS-en: üzemidő-figyelés a saját szerverén

A Checkmate hosztolása Managed VPS-en azt jelenti, hogy weboldalai és szerverei felügyelete egy saját gépen marad, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A Checkmate AGPL-3.0 licenc alatt álló, szabad és nyílt forráskódú monitorozó alkalmazás: rendelkezésre állás, válaszidők, incidensek, riasztások és állapotoldalak. Ez az útmutató a hivatalos Docker-képét követi a v4.0.0-s verzióban, és minden parancsot lefuttattunk egy Simafri VPS-en, mielőtt megírtuk: a telepítést Docker Compose-zal, a HTTPS-t, az első fiókot, a monitorokat és a riasztásokat, a mentéseket és a frissítéseket.

Simon Vasconcelos Lee Szerző: Közzétéve 2026. november 17-énOlvasási idő: 12 perc

Minden útmutató

A lényeg röviden

  1. Az AGPL-3.0 licenc lehetővé teszi, hogy a Checkmate-et saját magának, a csapatának vagy az ügyfeleinek futtassa, licenc vásárlása nélkül; ha módosítja, és másoknak hálózaton keresztül is használatra adja, megosztja a módosításait.
  2. Telepítse Docker Compose-zal: az egyetlen képbe csomagolt ghcr.io/bluewave-labs/checkmate és a MongoDB 8.0, a portot a 127.0.0.1 címen közzétéve, egy HTTPS-es fordított proxy mögött.
  3. Állítsa be a JWT_SECRET és az ENCRYPTION_KEY értékét, a nyilvános címét a CLIENT_HOST változóban, és adja hozzá a NODE_ENV=production beállítást, amely a referenciafájlból kimarad.
  4. Az első regisztráló személy lesz a Superadmin: hozza létre a fiókját közvetlenül az első indítás után, a többiek pedig meghívóval csatlakoznak.
  5. Mentse a MongoDB-adatbázist a mongodump eszközzel, és őrizze meg a .env fájlját, a frissítéshez pedig módosítsa a kép címkéjét: a migrációk indításkor maguktól lefutnak.

Mit tud a Checkmate

A Checkmate rendszeres időközönként ellenőrzi a szolgáltatásait, rögzít minden választ és annak válaszidejét, és riasztja Önt, ha valami nem válaszol többé. Fejlesztője, a BlueWave Labs, saját üzemeltetésű eszközként írja le, amely valós időben követi a szerverek hardverét, a rendelkezésre állást, a válaszidőket és az incidenseket.

Mit enged meg az AGPL-3.0 licenc

A Checkmate a GNU Affero General Public License 3-as verziója (AGPL-3.0) alatt jelenik meg. Ingyenesen használhatja saját magának, a cégének vagy az ügyfeleinek, másolhatja és módosíthatja.

Sajátos kikötése a hálózati használatra vonatkozik: ha módosítja a Checkmate-et, és más személyeknek hálózaton keresztül használatra adja a módosított változatát, fel kell ajánlania nekik annak forráskódját. A hivatalos kép módosítás nélküli futtatása, ahogy ebben az útmutatóban, nem keletkeztet ilyen kötelezettséget. A szoftvert garancia nélkül adják.

A tervezendő erőforrások

A dokumentáció szerény alsó határt szab: bármely Linux VPS legalább 1 GB RAM-mal. Hozzáteszi, hogy a MongoDB körülbelül 400 MB-ot használ egy olyan példányon, amely percenként több mint 300 szervert ellenőriz.

A szerver mérete tehát a monitorok számától, gyakoriságától és a megőrzött előzményektől függ. Egy Managed VPS esetén írja le nekünk, hogyan használja, és mi azt a méretet javasoljuk, amely megfelel.

Telepítés Docker Compose-zal

A 3.10-es verzió óta a Checkmate egyetlen képként érkezik, ghcr.io/bluewave-labs/checkmate néven, amely a felületet és az API-t is kiszolgálja. A MongoDB mellette fut, a saját konténerében. Egy olyan szerveren, amelyen a Docker Engine és a Compose bővítménye a Docker Ubuntuhoz készült tárolójából van telepítve, hozzon létre egy mappát, például /opt/checkmate néven, és tegye bele ezt a compose.yaml fájlt, amely a projekt referenciafájlján alapul:

compose.yaml
services:
  checkmate:
    image: ghcr.io/bluewave-labs/checkmate:v4.0.0
    restart: always
    ports:
      - "127.0.0.1:52345:52345"
    environment:
      - DB_CONNECTION_STRING=mongodb://mongodb:27017/uptime_db
      - CLIENT_HOST=https://status.example.com
      - JWT_SECRET=${JWT_SECRET:?set JWT_SECRET in .env}
      - ENCRYPTION_KEY=${ENCRYPTION_KEY:?set ENCRYPTION_KEY in .env}
      - NODE_ENV=production
    stop_grace_period: 60s
    healthcheck:
      test: ["CMD", "node", "-e", "require('http').get('http://localhost:52346/livez',r=>process.exit(r.statusCode===200?0:1)).on('error',()=>process.exit(1))"]
      interval: 15s
      timeout: 3s
      start_period: 60s
      start_interval: 2s
      retries: 3
    depends_on:
      mongodb:
        condition: service_healthy

  mongodb:
    image: mongo:8.0
    restart: always
    command: ["mongod", "--quiet", "--bind_ip_all"]
    volumes:
      - mongo-data:/data/db
    healthcheck:
      test: ["CMD", "bash", "-c", "exec 3<>/dev/tcp/127.0.0.1/27017"]
      interval: 5s
      timeout: 30s
      start_period: 0s
      start_interval: 1s
      retries: 30

volumes:
  mongo-data:

A két titkos érték egy mellette lévő .env fájlba kerül, amelyet a Docker Compose magától beolvas. Hozza létre úgy, hogy csak a root olvashassa, majd indítsa el a stacket:

Terminál, a /opt/checkmate mappában
umask 077
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -base64 32)" > .env
umask 022
docker compose up -d
docker compose ps

Az első indítás lefuttatja az adatbázis-migrációkat; a tesztszerverünkön az alkalmazás tíz másodpercen belül egészségesnek jelentette magát. Annak ellenőrzéséhez, hogy válaszol:

Terminál
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:52345/
curl -s http://127.0.0.1:52345/api/v1/auth/users/superadmin

Az első parancs 200 választ ad. A második "data":false választ ad, amíg nincs fiók, és true értéket, amint a Superadmin létrejött.

Az első fiók, a szerepkörök és a meghívók

A Checkmate-nek nincs alapértelmezett fiókja. Az első regisztráló személy lesz a Superadmin, ezért hozza létre a sajátját közvetlenül az első indítás után, mielőtt a címet megnyitja a nyilvánosság előtt. Egy SSH-alagút a szerver 52345-ös portját a számítógépére hozza, a http://localhost:52345 címre; adja hozzá a -p kapcsolót és az ügyfélterületén feltüntetett SSH-portot.

Terminál, a számítógépén
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Nyissa meg a http://localhost:52345 címet: a Checkmate a regisztrációs oldalát mutatja.
  2. Adja meg a keresztnevét, vezetéknevét, e-mail-címét és egy legalább 8 karakteres jelszót, amelyben van nagybetű, kisbetű, szám és különleges karakter.
  3. Regisztráljon: a vezérlőpultra jut, Superadminként bejelentkezve.

Ettől kezdve a nyilvános regisztráció le van zárva: a tesztszerverünkön minden új látogatót a bejelentkezési oldalra irányított, és a regisztrációs cím is oda vezetett. A többiek meghívóval csatlakoznak, a fiókbeállítások Team részéből, User vagy Admin szerepkörrel. A meghívó e-mailben megy ki, ezért szüksége van az alábbi SMTP-beállításokra, a benne lévő hivatkozás pedig egy óra után lejár.

SzerepkörMit tehet
UserMinden monitort, a vezérlőpultot, az ellenőrzéseket, az incidenseket, az állapotoldalakat és a beállításokat látja, anélkül hogy bármit módosítana
AdminMindent, amit egy User, továbbá a monitorokat, az értesítési csatornákat, az incidenseket, a karbantartási ablakokat, az állapotoldalakat, a meghívókat és a globális beállításokat, az SMTP-t is beleértve
SuperadminMindent, amit egy Admin, továbbá fiókok közvetlen létrehozását, egy másik felhasználó szerkesztését, egy szerepkör vagy jelszó módosítását

A v4.0.0 óta a címkék, az állapotoldalak és a proxyk kezelése Admin-művelet: az a User, aki korábban kezelhette őket, a frissítés után elveszíti ezt a hozzáférést.

HTTPS: a fordított proxy

A konténer HTTP-n, az 52345-ös porton szolgálja ki a Checkmate-et. A HTTPS-t egy előtte álló fordított proxy kezeli: a dokumentáció a Caddyt, a Traefiket és az nginxet említi. Mi a Caddyt teszteltük, a hivatalos Debian- és Ubuntu-tárolójából telepítve: maga szerzi be a Let’s Encrypt-tanúsítványt, megújítja, és alapértelmezésként továbbítja a Host fejlécet és az X-Forwarded-* fejléceket.

/etc/caddy/Caddyfile
status.example.com {
	reverse_proxy 127.0.0.1:52345
}
Terminál
sudo systemctl reload caddy

Az első monitorja és a riasztásai

  1. Az „Uptime” részben kattintson a „Create monitor” gombra, és válassza a HTTP/HTTPS lehetőséget.
  2. Adja meg az ellenőrizendő címet, egy nevet, amelyet egy riasztásban felismer, és egy gyakoriságot: a dokumentáció kritikus szolgáltatáshoz egy és öt perc közötti értéket ajánl.
  3. Mentse: a Checkmate azonnal lefuttatja az első ellenőrzést. A tesztszerverünkön a monitor egy perccel később már up állapotban volt.

E-mail: az SMTP-beállítások

Az e-mailes riasztások és a meghívók egy, az egész szerverre érvényes SMTP-kapcsolaton mennek ki, amelyet a „Settings” menü „Email” lapján állíthat be: kiszolgáló, port, felhasználó, jelszó és feladócím, majd „Save” és „Test”. Simafri VPS-en használjon hitelesítést igénylő SMTP-szervert az 587-es vagy a 465-ös porton: a domainje levelezési szolgáltatását vagy egy levélküldő szolgáltatást. Ezután hozzon létre egy e-mailes értesítést a riasztandó címekkel, és csatolja a monitoraihoz.

A Slack, a Discord, a Teams, a Telegram és a többi csatorna ugyanígy jön létre, a „Notifications” alatt, mindegyik a saját webhook-címével vagy tokenjével, és mindegyik egy „Test” gombbal.

Heartbeat monitorok az ütemezett feladataihoz

Egy heartbeat monitor egy magától futó feladatot figyel, például egy éjszakai mentést. Állítsa elő a csapat ping-kulcsát a „Settings” menü „Monitoring” lapján (csak egyszer jelenik meg), hozzon létre egy Heartbeat monitort egy sluggal és egy riasztási ablakkal, majd hívja meg a ping-címét a feladat végén:

crontab
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"

Ha a címhez hozzáadja a /fail részt vagy a feladat kilépési kódját, a monitor azonnal down állapotba kerül, anélkül hogy az ablak lejártát megvárná.

Állapotoldalak

A „Status pages” alatt egy Admin olyan oldalt tehet közzé, amely kiválasztott monitorokat és azok rendelkezésre állását mutatja, az ügyfelei vagy a csapata számára. A v4.0.0 óta minden állapotoldalnak van időzónája, alapértelmezésként UTC.

Mentések

Minden két helyen található: a MongoDB-adatbázisban, a mongo-data kötetben, és a .env fájljában. Ez utóbbit tartsa biztonságos helyen: az ENCRYPTION_KEY szükséges az adatbázisban tárolt titkos értékek olvasásához, a JWT_SECRET pedig bejelentkezve tartja a felhasználóit. A MongoDB-kép tartalmazza a mongodump eszközt:

Terminál, a /opt/checkmate mappában
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak

Ütemezze ezt a másolatot, és küldje a szerveren kívülre; egy heartbeat monitor jelezheti, ha valaha leáll a futása. A lemezre téve az archívumok a szerver éjszakai mentéseibe is bekerülnek.

Visszaállítás

Ugyanazon vagy egy új telepítésen, ugyanazzal a .env fájllal állítsa le az alkalmazást, töltse be az archívumot, majd indítsa el újra:

Terminál, a /opt/checkmate mappában
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate

A teljes ciklust kipróbáltuk a VPS-ünkön: mentés, az adatbázis tényleges törlése, visszaállítás. A monitor és a fiók visszatért, és a bejelentkezés azonnal újra működött.

A Checkmate v4.0.0 titkosított felhőmentéseket is kínál a Checkmate Connect révén, amely nem kötelező szolgáltatás, a béta idején ingyenes, és a telepítés regisztrálásához az ENCRYPTION_KEY értékre és egy Superadminra van szüksége. A fenti másolatok nélküle is működnek.

Frissítések

Olvassa el a kiadási megjegyzéseket, készítsen mentést, módosítsa a kép címkéjét a compose.yaml fájlban, majd töltse le az új képet, és hozza létre újra a konténert. Az adatbázis-migrációk indításkor maguktól lefutnak:

Terminál, a /opt/checkmate mappában
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Telemetria

A Checkmate naponta egy névtelen jelentést küld: egy telepítésazonosítót, a verziót, a telepítés módját és az egyes típusú monitorok számát, soha nem az Ön címeit vagy eredményeit. Ezt indításkor a naplójában jelzi is. A kikapcsolásához adja hozzá a TELEMETRY_ENABLED=false beállítást a checkmate szolgáltatás környezetéhez, majd futtassa a docker compose up -d parancsot.

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; a Checkmate továbbra is az Ön szoftvere marad, a monitoraival és az Ön beállításaival.

TémaCsapatainkÖn
A szerverRendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együttA tevékenységének megfelelő időpont
A felügyeletÉjjel-nappal, a hét minden napján követett szerver, beavatkozás a hívására való várakozás nélkülA saját monitorai, riasztásai és állapotoldalai a Checkmate-ben
CheckmateProaktív követés: a hibák, lassulások, az adatbázis és a lemezterület észlelése, javítás ajánlásaA telepítése, a frissítései és a beállításai, amelyeket Ön vagy MI-asszisztense alkalmaz
A felhasználók és a riasztásokA szerver, amely hordozza őket, felügyelve és mentveA fiókok, a szerepkörök, a meghívók és az értesítési csatornák
A mentésekMinden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együttA Checkmate saját adatbázis-exportjai, és a visszaállítási kérés, amikor szüksége van rá
Az átköltöztetésA jelenlegi szervere átköltöztetve, ingyenesenAz átállás időpontja

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.

A Checkmate egy Ön helyett karbantartott szerveren

Egy Simafri Managed VPS esetében csapataink naprakészen tartják Checkmate-példánya szerverét, éjjel-nappal felügyelik, és beavatkoznak anélkül, hogy a hívására várnának; proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön vagy MI-asszisztense alkalmaz. A mentések minden éjjel titkosítva, a gépen kívül készülnek, a visszaállításuk a díj része, jelenlegi szervere átköltöztetése pedig ingyenes.

Tovább a Managed VPS oldalára

Gyakori kérdések

Ingyenes a Checkmate?

Igen. A Checkmate AGPL-3.0 licenc alatt áll: futtathatja saját magának, a csapatának vagy az ügyfeleinek, licenc vásárlása nélkül. Ha módosítja, és másoknak hálózaton keresztül is használatra adja, megosztja a módosításait. Csak az azt futtató szerver költsége marad.

Hogyan telepíthető a Checkmate Docker Compose-zal?

Használja a referencia compose.yaml fájlt: a ghcr.io/bluewave-labs/checkmate képet és a MongoDB 8.0-t. Tegye a JWT_SECRET és az ENCRYPTION_KEY értékét egy .env fájlba, állítsa a CLIENT_HOST változót a https-es címére, a NODE_ENV változót production értékre, tegye közzé az 52345-ös portot a 127.0.0.1 címen, futtassa a docker compose up -d parancsot, és helyezzen elé egy HTTPS-es fordított proxyt.

Mik a Checkmate alapértelmezett belépési adatai?

Nincsenek ilyenek. Egy új példányon az első regisztráló személy lesz a Superadmin. Hozza létre a fiókját közvetlenül az első indítás után, egy SSH-alagúton keresztül; ezután a látogatókat a bejelentkezési oldalra irányítja, az új felhasználók pedig meghívóval csatlakoznak.

Mennyi memória kell a Checkmate-nek?

A dokumentáció legalább 1 GB RAM-mal rendelkező Linux VPS-t kér. A tesztszerverünkön egy friss telepítés körülbelül 300 MB-ot használt a Checkmate-hez és 280 MB-ot a MongoDB-hez. A lemezigény a monitorok számával, gyakoriságával és a megőrzött előzményekkel nő, ez alapértelmezésként 90 nap.

Hogyan küldhetem a Checkmate riasztásait e-mailben?

Állítsa be az SMTP-kapcsolatot a Settings menü Email lapján: kiszolgáló, 587-es vagy 465-ös port, felhasználó, jelszó és feladó, majd Save és Test. Hozzon létre egy e-mailes értesítést a riasztandó címekkel, és csatolja a monitoraihoz. A meghívók ugyanezeket a beállításokat használják.

Hogyan menthető a Checkmate?

Exportálja a MongoDB-adatbázist a docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db paranccsal, és őrizzen meg egy másolatot a .env fájljáról, amelynek ENCRYPTION_KEY értéke szükséges a tárolt titkos értékek olvasásához. A visszaállítás a mongorestore --archive --gzip --drop paranccsal történik, leállított alkalmazás mellett.

Hogyan frissíthető a Checkmate?

Olvassa el a kiadási megjegyzéseket, és készítsen mentést, módosítsa a kép címkéjét a compose.yaml fájlban, majd futtassa a docker compose pull és a docker compose up -d parancsot. Az adatbázis-migrációk indításkor maguktól lefutnak.

A Managed VPS lefedi a Checkmate-et?

A Managed VPS a szervert fedi le: a rendszert, a biztonságot, a felügyeletet és a mentéseket. Csapataink emellett proaktívan követik a példányát, és javasolják a hasznos javításokat, amelyeket Ön alkalmaz. Az alkalmazáson belüli beavatkozás óradíjban vagy átalánydíjban számlázódik.

Források és hivatalos dokumentáció

Kapcsolódó útmutatók

Uptime Kuma hosztolása Managed VPS-en: figyelje szolgáltatásait folyamatosanAz Uptime Kuma hosztolása Managed VPS-en azt jelenti, hogy webhelyeit, API-it és szervereit egy saját gépről figyeli, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. Az Uptime Kuma MIT licenc alatt álló szabad szoftver. Ez az útmutató a hivatalos dokumentációját követi: a telepítést Docker Compose-zal, a HTTPS-t, az adatbázist, az értesítéseket, a mentéseket és a frissítéseket.Egy VPS biztonsági mentései: mit ellenőrizzen aláírás előttA VPS-ajánlatok szinte mindig ezt ígérik: „mentés a csomagban”. E néhány szó mögött lehet minden éjjel készülő, a gépen kívül őrzött és szakértők által visszaállított másolat, de lehet egy a szerverrel azonos lemezen tárolt pillanatkép is. Ez az útmutató megadja azokat a kérdéseket, amelyek különbséget tesznek, azt, mit jelent az egyes válasz, és azt, hogyan ellenőrizheti, hogy egy mentés visszaállítható.Menedzselt és nem menedzselt VPS közötti különbség: ki mit végezA menedzselt és a nem menedzselt VPS közötti különbség egyetlen kérdésen múlik: ki gondoskodik a szerverről, miután az már fut. A „menedzselt” szónak ugyanakkor nincs hivatalos meghatározása: szolgáltatónként a rendszer egyszerű telepítésétől a szerver teljes üzemeltetéséig terjedhet a jelentése. Ez az útmutató megmutatja, ki mit végez, feladatról feladatra, a támogatás köztes szintjével együtt, és megadja azokat a kérdéseket, amelyek aláírás előtt eloszlatják a kétértelműséget.
Kapcsolatfelvétel