Gostovanje Checkmate na Managed VPS: nadzor razpoložljivosti na vašem strežniku

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.

Simon Vasconcelos Lee Avtor: Objavljeno 17. novembra 2026Čas branja: 12 minut

Vsi vodniki

Na kratko

  1. Licenca AGPL-3.0 vam dovoljuje, da Checkmate 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.
  2. Namestite ga z Docker Compose: slika vse v enem 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.
  3. Nastavite JWT_SECRET, ENCRYPTION_KEY in svoj javni naslov v CLIENT_HOST ter dodajte NODE_ENV=production, ki ga referenčna datoteka izpušča.
  4. Prva oseba, ki se registrira, postane Superadmin: svoj račun ustvarite takoj po prvem zagonu, vsi drugi pa se pridružijo s povabilom.
  5. Zbirko podatkov MongoDB varnostno kopirajte z mongodump in shranite svojo datoteko .env, posodabljajte pa tako, da spremenite oznako slike: migracije se ob zagonu izvedejo same.

Kaj počne Checkmate

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.

Kaj dovoljuje licenca AGPL-3.0

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.

Viri, ki jih je treba predvideti

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.

Namestitev z Docker Compose

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:

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:

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:

Terminal, v mapi /opt/checkmate
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

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:

Terminal
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.

Prvi račun, vloge in povabila

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.

Terminal, na vašem računalniku
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Odprite http://localhost:52345: Checkmate prikaže svojo stran za registracijo.
  2. Vnesite ime, priimek, e-poštni naslov in geslo z vsaj 8 znaki, z veliko črko, malo črko, številko in posebnim znakom.
  3. Registrirajte se: znajdete se na nadzorni plošči, prijavljeni kot Superadmin.

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.

VlogaKaj lahko počne
UserVidi vse monitorje, nadzorno ploščo, preverjanja, incidente, statusne strani in nastavitve, ne da bi kar koli spreminjal
AdminVse, kar lahko User, poleg tega monitorje, kanale za obvestila, incidente, vzdrževalna okna, statusne strani, povabila in globalne nastavitve, vključno s SMTP
SuperadminVse, 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.

HTTPS: obratni posredniški strežnik

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-*.

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

Vaš prvi monitor in njegova opozorila

  1. V „Uptime“ kliknite „Create monitor“ in izberite HTTP/HTTPS.
  2. Vnesite naslov, ki ga je treba preverjati, ime, ki ga boste prepoznali v opozorilu, in interval: za kritično storitev dokumentacija priporoča eno do pet minut.
  3. Shranite: Checkmate takoj izvede prvo preverjanje. Na našem testnem VPS je monitor minuto pozneje kazal, da je storitev dosegljiva.

E-pošta: nastavitve SMTP

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“.

Monitorji Heartbeat za vaša načrtovana opravila

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:

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"

Če URL-ju dodate /fail ali izhodno kodo opravila, se monitor takoj označi kot nedosegljiv, ne da bi čakal, da okno poteče.

Statusne strani

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.

Varnostne kopije

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:

Terminal, v mapi /opt/checkmate
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.

Obnova

Na isti ali novi namestitvi, z isto datoteko .env, ustavite aplikacijo, naložite arhiv, nato jo znova zaženite:

Terminal, v mapi /opt/checkmate
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.

Posodobitve

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:

Terminal, v mapi /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Telemetrija

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.

Kdo kaj dela na Managed VPS

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.

TemaNaše ekipeVi
StrežnikPosodobitve sistema in varnosti, vključno s posegi na strežnikuTrenutek, ki ustreza vaši dejavnosti
NadzorStrežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klicVaši lastni monitorji, opozorila in statusne strani v Checkmate
CheckmateProaktivno spremljanje: napake, upočasnitve, zbirka podatkov in prostor na disku, s priporočenim popravkomNamestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik
Uporabniki in opozorilaStrežnik, ki jih nosi, pod nadzorom in varnostno kopiranRačuni, vloge, povabila in kanali za obvestila
Varnostne kopijeVsako noč, šifrirane in shranjene zunaj stroja; obnova je vključenaIzvozi zbirke podatkov, značilni za Checkmate, in zahteva za obnovo, ko jo potrebujete
SelitevSelitev vašega sedanjega strežnika, brezplačnoTrenutek 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.

Checkmate na strežniku, ki ga vzdržujemo za vas

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.

Odkrijte Managed VPS

Pogosta vprašanja

Ali je Checkmate brezplačen?

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.

Kako namestim Checkmate z Docker Compose?

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.

Katere so privzete poverilnice za Checkmate?

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.

Koliko pomnilnika potrebuje Checkmate?

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.

Kako pošiljam opozorila Checkmate po e-pošti?

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.

Kako varnostno kopiram Checkmate?

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.

Kako posodobim Checkmate?

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.

Ali Managed VPS pokriva Checkmate?

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.

Viri in uradna dokumentacija

Stopite v stik z nami