Gostovanje Checkmate na Managed VPS pomeni, da nadzor nad vašimi spletišči in strežniki teče na lastnem stroju, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. Checkmate je prosta, odprtokodna aplikacija za nadzor pod licenco AGPL-3.0: razpoložljivost, odzivni časi, incidenti, opozorila in statusne strani. Ta vodnik sledi njegovi uradni sliki Docker v različici v4.0.0, vsak ukaz pa smo pred pisanjem zagnali na VPS Simafri: namestitev z Docker Compose, HTTPS, prvi račun, monitorji in opozorila, varnostne kopije in posodobitve.
Avtor: Simon Vasconcelos Lee
Objavljeno 17. novembra 2026Čas branja: 12 minut
ghcr.io/bluewave-labs/checkmate in MongoDB 8.0, z vrati, objavljenimi na 127.0.0.1 za obratnim posredniškim strežnikom s HTTPS.JWT_SECRET, ENCRYPTION_KEY in svoj javni naslov v CLIENT_HOST ter dodajte NODE_ENV=production, ki ga referenčna datoteka izpušča.mongodump in shranite svojo datoteko .env, posodabljajte pa tako, da spremenite oznako slike: migracije se ob zagonu izvedejo same.Checkmate v rednih presledkih preverja vaše storitve, zabeleži vsak odgovor in njegov odzivni čas ter vas opozori, ko se kaj preneha odzivati. Njegov razvijalec, BlueWave Labs, ga opisuje kot orodje za lastno gostovanje, ki v realnem času spremlja strojno opremo strežnikov, razpoložljivost, odzivne čase in incidente.
Checkmate je objavljen pod licenco GNU Affero General Public License, različica 3 (AGPL-3.0). Brezplačno ga lahko uporabljate, zase, za svoje podjetje ali svoje stranke, ga kopirate in spreminjate.
Njena posebna določba zadeva uporabo prek omrežja: če Checkmate spremenite in drugim ljudem omogočite, da vašo spremenjeno različico uporabljajo prek omrežja, jim morate ponuditi njeno izvorno kodo. Poganjanje uradne slike brez sprememb, kot v tem vodniku, takšne obveznosti ne ustvarja. Programska oprema je na voljo brez jamstva.
Dokumentacija postavlja skromen spodnji prag: kateri koli VPS z Linuxom z 1 GB RAM ali več. Dodaja, da MongoDB porabi približno 400 MB na instanci, ki vsako minuto preverja več kot 300 strežnikov.
Velikost strežnika je torej odvisna od števila monitorjev, njihovega intervala in zgodovine, ki jo hranite. Na Managed VPS nam opišite, kako ga uporabljate, in priporočili vam bomo ustrezno velikost.
Od različice 3.10 je Checkmate na voljo kot ena sama slika, ghcr.io/bluewave-labs/checkmate, ki streže tako vmesnik kot API. MongoDB teče ob njej, v lastnem vsebniku. Na strežniku z Docker Engine in njegovim vtičnikom Compose, nameščenima iz Dockerjevega repozitorija za Ubuntu, ustvarite mapo, kot je /opt/checkmate, in vanjo postavite ta compose.yaml, pripravljen na podlagi referenčne datoteke projekta:
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:
Skrivnosti gresta v datoteko .env poleg nje, ki jo Docker Compose prebere sam. Ustvarite jo tako, da jo lahko bere samo root, nato zaženite sklad:
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: referenčna datoteka jih objavi brez naslova, Docker pa jih tedaj odpre na vseh naslovih strežnika. Objavljena lokalno so dosegljiva le prek obratnega posredniškega strežnika.CLIENT_HOST je naslov, ki ga vpisujejo vaši uporabniki, s https://. Checkmate ga uporablja za preverjanja zahtev z drugih izvorov in za povezave v svojih opozorilih in e-poštnih sporočilih.NODE_ENV=production: README ga zahteva pri resničnih namestitvah. Brez njega aplikacija teče v razvojnem načinu, ki izklopi omejevalnik števila zahtev API.ENCRYPTION_KEY je v referenčni datoteki neobvezen. Šifrira skrivnosti, ki jih Checkmate shranjuje, v4.0.0 pa ga zahteva za monitorje Docker s TLS in za Checkmate Connect. Nastavite ga od začetka: to je preprosteje, kot da ga dodate pozneje.latest in jo prenese ob vsakem zagonu. Polna različica, tukaj v4.0.0, vam omogoča, da sami izberete trenutek vsake posodobitve.mongo-data hrani vse vaše podatke: monitorje, preverjanja, uporabnike in nastavitve.Prvi zagon izvede migracije zbirke podatkov; na našem testnem VPS je aplikacija v manj kot desetih sekundah sporočila, da je zdrava. Da preverite, ali se odziva:
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
Prvi ukaz odgovori z 200. Drugi odgovori z "data":false, dokler ne obstaja noben račun, in s true, ko je Superadmin ustvarjen.
Checkmate nima privzetega računa. Prva oseba, ki se registrira, postane Superadmin, zato svoj račun ustvarite takoj po prvem zagonu, preden naslov odprete javnosti. Tunel SSH prenese vrata 52345 strežnika na vaš računalnik, na http://localhost:52345; dodajte -p in vrata SSH, prikazana v vašem uporabniškem območju.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate prikaže svojo stran za registracijo.Od tedaj je javna registracija zaprta: na našem testnem VPS je bil vsak nov obiskovalec preusmerjen na stran za prijavo, tja pa je vodil tudi naslov za registracijo. Drugi se pridružijo s povabilom, iz razdelka Team v nastavitvah računa, z vlogo User ali Admin. Povabilo se pošlje po e-pošti, zato potrebuje spodaj opisane nastavitve SMTP, njegova povezava pa poteče po eni uri.
| Vloga | Kaj lahko počne |
|---|---|
| User | Vidi vse monitorje, nadzorno ploščo, preverjanja, incidente, statusne strani in nastavitve, ne da bi kar koli spreminjal |
| Admin | Vse, kar lahko User, poleg tega monitorje, kanale za obvestila, incidente, vzdrževalna okna, statusne strani, povabila in globalne nastavitve, vključno s SMTP |
| Superadmin | Vse, kar lahko Admin, poleg tega neposredno ustvarjanje računov, urejanje drugega uporabnika ter spreminjanje vloge ali gesla |
Od v4.0.0 so oznake, statusne strani in posredniški strežniki dejanja, pridržana Adminu: User, ki jih je prej lahko upravljal, po posodobitvi ta dostop izgubi.
Vsebnik Checkmate streže prek HTTP, na vratih 52345. Za HTTPS poskrbi obratni posredniški strežnik pred njim: dokumentacija navaja Caddy, Traefik in nginx. Preizkusili smo Caddy, nameščen iz njegovega uradnega repozitorija za Debian in Ubuntu: sam pridobi potrdilo Let’s Encrypt, ga podaljšuje ter privzeto posreduje glavo Host in glave X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST mora vsebovati isti naslov https:// kot posredniški strežnik. Ko ga spremenite, zaženite docker compose up -d, da vsebnik znova ustvarite.Opozorila po e-pošti in povabila gredo prek povezave SMTP za ves strežnik, nastavljene pod „Settings“, zavihek „Email“: gostitelj, vrata, uporabnik, geslo in naslov pošiljatelja, nato „Save“ in „Test“. Na VPS Simafri uporabite strežnik SMTP s preverjanjem pristnosti, na vratih 587 ali 465: poštno storitev vaše domene ali storitev za pošiljanje. Nato ustvarite obvestilo po e-pošti z naslovi, ki jih je treba opozoriti, in ga povežite s svojimi monitorji.
Slack, Discord, Teams, Telegram in drugi kanali se ustvarijo enako, pod „Notifications“, vsak s svojim naslovom webhook ali žetonom in vsak z gumbom „Test“.
Monitor Heartbeat nadzira opravilo, ki teče samo, kot je nočna varnostna kopija. Ustvarite ključ za ping ekipe pod „Settings“, zavihek „Monitoring“ (prikaže se le enkrat), ustvarite monitor Heartbeat s slugom in oknom za opozorilo, nato ob koncu opravila pokličite njegov URL za ping:
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"
Če URL-ju dodate /fail ali izhodno kodo opravila, se monitor takoj označi kot nedosegljiv, ne da bi čakal, da okno poteče.
Pod „Status pages“ Admin objavi stran, ki navaja izbrane monitorje in njihovo razpoložljivost, za vaše stranke ali vašo ekipo. Od v4.0.0 ima vsaka statusna stran časovni pas, privzeto UTC.
Vse je na dveh mestih: v zbirki podatkov MongoDB, v nosilcu mongo-data, in v vaši datoteki .env. Slednjo hranite na varnem: ENCRYPTION_KEY je potreben za branje skrivnosti, shranjenih v zbirki podatkov, JWT_SECRET pa ohranja vaše uporabnike prijavljene. Slika MongoDB vsebuje mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
To kopijo načrtujte in jo pošiljajte zunaj strežnika; monitor Heartbeat vam lahko sporoči, če se kdaj preneha izvajati. Shranjeni na disku arhivi vstopijo tudi v nočne varnostne kopije strežnika.
Na isti ali novi namestitvi, z isto datoteko .env, ustavite aplikacijo, naložite arhiv, nato jo znova zaženite:
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate
Celoten cikel smo preizkusili na svojem VPS: varnostna kopija, zbirka podatkov dejansko izbrisana, obnova. Monitor in račun sta se vrnila, prijava pa je takoj znova delovala.
Checkmate v4.0.0 ponuja tudi šifrirane varnostne kopije v oblaku prek Checkmate Connect, neobvezne storitve, brezplačne v času beta različice, ki potrebuje ENCRYPTION_KEY in Superadmina za vpis namestitve. Zgornje kopije delujejo tudi brez nje.
Preberite opombe ob izdaji, naredite varnostno kopijo, spremenite oznako slike v compose.yaml, nato prenesite novo sliko in vsebnik znova ustvarite. Migracije zbirke podatkov se ob zagonu izvedejo same:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump in mongorestore. Nobena nova spremenljivka okolja ni potrebna.checkmate-client, checkmate-backend in checkmate-mongo, ki se ne posodabljajo več. Preklopite na ghcr.io/bluewave-labs/checkmate in obdržite svojo storitev MongoDB in njen nosilec; spremenljivke UPTIME_APP_* se ne berejo več.Checkmate pošlje eno anonimno poročilo na dan: ID namestitve, različico, način namestitve in število monitorjev vsake vrste, nikoli vaših URL-jev ali rezultatov. To ob zagonu zapiše v svoj dnevnik. Če jo želite izklopiti, dodajte TELEMETRY_ENABLED=false v okolje storitve checkmate, nato zaženite docker compose up -d.
Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; Checkmate ostaja vaša programska oprema, z njegovimi monitorji in vašimi nastavitvami.
| Tema | Naše ekipe | Vi |
|---|---|---|
| Strežnik | Posodobitve sistema in varnosti, vključno s posegi na strežniku | Trenutek, ki ustreza vaši dejavnosti |
| Nadzor | Strežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klic | Vaši lastni monitorji, opozorila in statusne strani v Checkmate |
| Checkmate | Proaktivno spremljanje: napake, upočasnitve, zbirka podatkov in prostor na disku, s priporočenim popravkom | Namestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik |
| Uporabniki in opozorila | Strežnik, ki jih nosi, pod nadzorom in varnostno kopiran | Računi, vloge, povabila in kanali za obvestila |
| Varnostne kopije | Vsako noč, šifrirane in shranjene zunaj stroja; obnova je vključena | Izvozi zbirke podatkov, značilni za Checkmate, in zahteva za obnovo, ko jo potrebujete |
| Selitev | Selitev vašega sedanjega strežnika, brezplačno | Trenutek preklopa |
Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.
Z Managed VPS Simafri naše ekipe strežnik vaše instance Checkmate sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.
Da. Checkmate je pod licenco AGPL-3.0: lahko ga poganjate zase, za svojo ekipo ali svoje stranke, ne da bi kupili licenco. Če ga spremenite in ga drugim omogočite uporabljati prek omrežja, svoje spremembe delite. Ostane strošek strežnika, na katerem teče.
Uporabite referenčni compose.yaml: sliko ghcr.io/bluewave-labs/checkmate in MongoDB 8.0. JWT_SECRET in ENCRYPTION_KEY postavite v datoteko .env, CLIENT_HOST nastavite na svoj naslov https, NODE_ENV pa na production, vrata 52345 objavite na 127.0.0.1, zaženite docker compose up -d in predenj postavite obratni posredniški strežnik s HTTPS.
Teh ni. Prva oseba, ki se registrira na novi instanci, postane Superadmin. Svoj račun ustvarite takoj po prvem zagonu, prek tunela SSH; nato so obiskovalci preusmerjeni na stran za prijavo, novi uporabniki pa se pridružijo s povabilom.
Dokumentacija zahteva VPS z Linuxom z 1 GB RAM ali več. Na našem testnem VPS je sveža namestitev porabila približno 300 MB za Checkmate in 280 MB za MongoDB. Disk raste s številom monitorjev, njihovim intervalom in zgodovino, ki jo hranite, privzeto 90 dni.
Povezavo SMTP nastavite pod Settings, zavihek Email: gostitelj, vrata 587 ali 465, uporabnik, geslo in pošiljatelj, nato Save in Test. Ustvarite obvestilo po e-pošti z naslovi, ki jih je treba opozoriti, in ga povežite s svojimi monitorji. Povabila uporabljajo iste nastavitve.
Zbirko podatkov MongoDB izvozite z docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db in shranite kopijo svoje datoteke .env, katere ENCRYPTION_KEY je potreben za branje shranjenih skrivnosti. Obnovite z mongorestore --archive --gzip --drop, ko je aplikacija ustavljena.
Preberite opombe ob izdaji in naredite varnostno kopijo, spremenite oznako slike v compose.yaml, nato zaženite docker compose pull in docker compose up -d. Migracije zbirke podatkov se ob zagonu izvedejo same.
Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe tudi proaktivno spremljajo vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.
Simafri
Pogovorimo se o vašem projektu
Povejte nam v nekaj besedah, kaj potrebujete: hitro se vam oglasimo.
Hvala! Vaše povpraševanje je bilo poslano. Kmalu vam bomo odgovorili.
Imate raje e-pošto? Pišite nam na support@simafri.com.