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.
Szerző: Simon Vasconcelos Lee
Közzétéve 2026. november 17-énOlvasási idő: 12 perc
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.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.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.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.
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 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.
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:
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:
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
127.0.0.1 címen közzétéve: a referenciafájl cím nélkül teszi közzé, a Docker pedig ilyenkor a szerver minden címén megnyitja. Helyileg közzétéve csak a fordított proxyn keresztül érhető el.CLIENT_HOST az a cím, amelyet a felhasználói begépelnek, https:// előtaggal. A Checkmate a különböző eredetű (cross-origin) kérések ellenőrzéséhez, valamint a riasztásaiban és e-mailjeiben szereplő hivatkozásokhoz használja.NODE_ENV=production: a README éles telepítésekhez kéri. Nélküle az alkalmazás fejlesztői módban fut, amely kikapcsolja az API kéréskorlátozóját.ENCRYPTION_KEY a referenciafájlban nem kötelező. A Checkmate által tárolt titkos értékeket titkosítja, a v4.0.0 pedig megköveteli a TLS-en keresztüli Docker-monitorokhoz és a Checkmate Connecthez. Állítsa be már az elején: egyszerűbb, mint később hozzáadni.latest címkét követi, és minden indításkor letölti. A teljes verziószám, itt v4.0.0, lehetővé teszi, hogy Ön válassza meg az egyes frissítések időpontját.mongo-data, az összes adatát őrzi: monitorokat, ellenőrzéseket, felhasználókat és beállításokat.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:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345 címet: a Checkmate a regisztrációs oldalát mutatja.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ör | Mit tehet |
|---|---|
| User | Minden 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 |
| Admin | Mindent, 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 |
| Superadmin | Mindent, 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.
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.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST ugyanazt a https:// címet kell tartalmaznia, mint a proxy. A módosítása után futtassa a docker compose up -d parancsot a konténer újbóli létrehozásához.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.
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:
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á.
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.
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:
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.
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:
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.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump és a mongorestore eszközt. Új környezeti változóra nincs szükség.checkmate-client, checkmate-backend és checkmate-mongo képeket futtathatja, amelyek már nem frissülnek. Váltson a ghcr.io/bluewave-labs/checkmate képre, és tartsa meg a MongoDB-szolgáltatását és annak kötetét; az UPTIME_APP_* változókat már nem olvassa be.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.
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éma | Csapataink | Ön |
|---|---|---|
| A szerver | Rendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együtt | A 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ül | A saját monitorai, riasztásai és állapotoldalai a Checkmate-ben |
| Checkmate | Proaktív követés: a hibák, lassulások, az adatbázis és a lemezterület észlelése, javítás ajánlása | A 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ások | A szerver, amely hordozza őket, felügyelve és mentve | A fiókok, a szerepkörök, a meghívók és az értesítési csatornák |
| A mentések | Minden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együtt | A 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és | A jelenlegi szervere átköltöztetve, ingyenesen | Az á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.
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.
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.
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.
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.
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.
Á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.
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.
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 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.
Simafri
Beszéljünk a weboldaláról
Meséljen néhány szóban a projektjéről: hamarosan jelentkezünk.
Köszönjük! Kérését elküldtük. Hamarosan válaszolunk.
Inkább e-mailben? Írjon nekünk ide: support@simafri.com.