Checkmate’i majutamine Managed VPS-is: käideldavuse seire teie enda serveris

Checkmate’i majutamine Managed VPS-is tähendab, et teie veebisaitide ja serverite valvamine toimub masinas, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. Checkmate on AGPL-3.0 litsentsiga vaba ja avatud lähtekoodiga seirerakendus: käideldavus, vastamisajad, intsidendid, hoiatused ja olekulehed. See juhend järgib selle ametlikku Dockeri tõmmist versioonis v4.0.0 ning käivitasime enne kirjutamist iga käsu Simafri VPS-is: paigaldus Docker Compose’iga, HTTPS, esimene konto, monitorid ja hoiatused, varukoopiad ja uuendused.

Simon Vasconcelos Lee Autor: Avaldatud 17. novembril 2026Lugemisaeg: 12 minutit

Kõik juhendid

Lühidalt

  1. AGPL-3.0 litsents lubab Checkmate’i käitada enda, oma meeskonna või klientide jaoks, ilma et peaksite litsentsi ostma; kui seda muudate ja lasete teistel seda võrgu kaudu kasutada, jagate oma muudatusi.
  2. Paigaldage see Docker Compose’iga: kõik-ühes tõmmis ghcr.io/bluewave-labs/checkmate ja MongoDB 8.0, port avaldatud aadressil 127.0.0.1 HTTPS-i pöördproksi taga.
  3. Määrake JWT_SECRET, ENCRYPTION_KEY ja oma avalik aadress muutujas CLIENT_HOST ning lisage NODE_ENV=production, mis viitefailist puudub.
  4. Esimesena registreerunud inimesest saab Superadmin: looge oma konto kohe pärast esimest käivitamist, seejärel liituvad kõik teised kutse kaudu.
  5. Varundage MongoDB andmebaas tööriistaga mongodump ja hoidke alles oma fail .env, seejärel uuendage, muutes tõmmise silti: migratsioonid käivituvad käivitamisel iseenesest.

Mida Checkmate teeb

Checkmate kontrollib teie teenuseid korrapäraste ajavahemike järel, salvestab iga vastuse ja selle vastamisaja ning hoiatab teid, kui miski enam ei vasta. Selle arendaja BlueWave Labs kirjeldab seda kui ise majutatavat tööriista, mis jälgib reaalajas serveri riistvara, käideldavust, vastamisaegu ja intsidente.

Mida AGPL-3.0 litsents lubab

Checkmate avaldatakse GNU Affero General Public License’i versiooni 3 (AGPL-3.0) all. Võite seda tasuta kasutada enda, oma ettevõtte või klientide jaoks, seda kopeerida ja muuta.

Selle eriline tingimus puudutab võrgukasutust: kui muudate Checkmate’i ja lasete teistel inimestel oma muudetud versiooni võrgu kaudu kasutada, peate neile pakkuma selle lähtekoodi. Ametliku tõmmise muutmata käitamine, nagu selles juhendis, sellist kohustust ei loo. Tarkvara pakutakse ilma garantiita.

Arvestatavad ressursid

Dokumentatsioon seab tagasihoidliku alammäära: mis tahes Linuxi VPS, millel on 1 GB või rohkem RAM-i. See lisab, et MongoDB kasutab umbes 400 MB instantsis, mis kontrollib igal minutil üle 300 serveri.

Serveri suurus sõltub seega monitoride arvust, nende intervallist ja ajaloost, mida hoiate. Managed VPS-i puhul kirjeldage meile oma kasutust ja me soovitame teile sobiva suuruse.

Paigaldus Docker Compose’iga

Alates versioonist 3.10 tarnitakse Checkmate’i ühe tõmmisena, ghcr.io/bluewave-labs/checkmate, mis serveerib nii liidest kui ka API-t. MongoDB töötab selle kõrval oma konteineris. Serveris, kuhu on Dockeri Ubuntu hoidlast paigaldatud Docker Engine ja selle Compose’i plugin, looge kaust, näiteks /opt/checkmate, ja pange sinna see compose.yaml, mis põhineb projekti viitefailil:

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:

Kaks saladust lähevad selle kõrvale faili .env, mille Docker Compose loeb iseenesest. Looge see loetavaks ainult rootile ja käivitage seejärel komplekt:

Terminal, kaustas /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

Esimene käivitamine käitab andmebaasi migratsioonid; meie test-VPS-is teatas rakendus end tervena vähem kui kümne sekundiga. Et kontrollida, kas see vastab:

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

Esimene käsk vastab 200. Teine vastab "data":false seni, kuni ühtegi kontot pole, ja true, kui Superadmin on loodud.

Esimene konto, rollid ja kutsed

Checkmate’il pole vaikekontot. Esimesena registreerunud inimesest saab Superadmin, seega looge oma konto kohe pärast esimest käivitamist, enne kui aadressi avalikkusele avate. SSH-tunnel toob serveri pordi 52345 teie arvutisse aadressile http://localhost:52345; lisage -p ja teie kliendialas näidatud SSH-port.

Terminal, teie arvutis
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Avage http://localhost:52345: Checkmate näitab oma registreerumislehte.
  2. Sisestage oma eesnimi, perekonnanimi, e-posti aadress ja vähemalt 8-märgiline parool, milles on suurtäht, väiketäht, number ja erimärk.
  3. Registreeruge: jõuate juhtpaneelile, sisse logituna Superadminina.

Sellest hetkest on avalik registreerumine suletud: meie test-VPS-is suunati iga uus külastaja sisselogimislehele ja ka registreerumisaadress viis sinna. Teised liituvad kutse kaudu, kontosätete jaotisest Team, rolliga User või Admin. Kutse saadetakse e-postiga, seega vajab see allpool kirjeldatud SMTP sätteid, ja selle link aegub ühe tunni pärast.

RollMida see võimaldab
UserNäha kõiki monitore, juhtpaneeli, kontrolle, intsidente, olekulehti ja sätteid, ilma midagi muutmata
AdminKõike, mida User, lisaks monitorid, teavituskanalid, intsidendid, hooldusaknad, olekulehed, kutsed ja üldsätted, SMTP kaasa arvatud
SuperadminKõike, mida Admin, lisaks kontode otse loomine, teise kasutaja muutmine, rolli või parooli vahetamine

Alates versioonist v4.0.0 on sildid, olekulehed ja proksid Admini toimingud: User, kes sai neid varem hallata, kaotab pärast uuendust selle juurdepääsu.

HTTPS: pöördproksi

Konteiner serveerib Checkmate’i HTTP kaudu pordil 52345. HTTPS-i eest hoolitseb selle ees olev pöördproksi: dokumentatsioon nimetab Caddy, Traefiku ja nginxi. Testisime Caddy’t, mis paigaldati selle ametlikust Debiani ja Ubuntu hoidlast: see hangib Let’s Encrypti sertifikaadi ise, uuendab seda ning edastab vaikimisi päise Host ja päised X-Forwarded-*.

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

Teie esimene monitor ja selle hoiatused

  1. Klõpsake jaotises «Uptime» nupul «Create monitor» ja valige HTTP/HTTPS.
  2. Sisestage kontrollitav aadress, nimi, mille hoiatuses ära tunnete, ja intervall: dokumentatsioon soovitab kriitilise teenuse jaoks ühte kuni viit minutit.
  3. Salvestage: Checkmate teeb esimese kontrolli kohe. Meie test-VPS-is näitas monitor minut hiljem teenust töötavana.

E-post: SMTP sätted

E-posti hoiatused ja kutsed liiguvad kogu serveri ühise SMTP-ühenduse kaudu, mis määratakse jaotise «Settings» vahekaardil «Email»: host, port, kasutaja, parool ja saatja aadress, seejärel «Save» ja «Test». Simafri VPS-is kasutage autenditud SMTP-serverit pordil 587 või 465: teie domeeni e-posti teenust või saatmisteenust. Seejärel looge e-posti teavitus hoiatatavate aadressidega ja siduge see oma monitoridega.

Slack, Discord, Teams, Telegram ja teised kanalid luuakse samamoodi jaotises «Notifications», igaüks oma veebihaagi aadressi või loaga ja igaüks nupuga «Test».

Heartbeat-monitorid teie ajastatud töödele

Heartbeat-monitor valvab tööd, mis käivitub iseenesest, näiteks öist varundust. Genereerige meeskonna pingivõti jaotise «Settings» vahekaardil «Monitoring» (seda näidatakse ainult üks kord), looge Heartbeat-monitor lühinime ja hoiatusaknaga ning kutsuge seejärel töö lõpus selle pingi-URL-i:

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"

Kui lisate URL-ile /fail või töö väljumiskoodi, märgitakse monitor kohe mittetöötavaks, ootamata akna möödumist.

Olekulehed

Jaotises «Status pages» avaldab Admin lehe, mis loetleb valitud monitorid ja nende käideldavuse, teie klientidele või meeskonnale. Alates versioonist v4.0.0 on igal olekulehel ajavöönd, vaikimisi UTC.

Varukoopiad

Kõik asub kahes kohas: MongoDB andmebaasis, köites mongo-data, ja teie failis .env. Hoidke viimast turvaliselt: ENCRYPTION_KEY on vajalik andmebaasi salvestatud saladuste lugemiseks ja JWT_SECRET hoiab teie kasutajad sisse logituna. MongoDB tõmmis sisaldab tööriista mongodump:

Terminal, kaustas /opt/checkmate
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak

Ajastage see koopia ja saatke see serverist välja; Heartbeat-monitor annab teile teada, kui see kunagi enam ei käivitu. Kettale salvestatuna kuuluvad arhiivid ka serveri öistesse varukoopiatesse.

Taastamine

Samas või uues paigalduses, sama failiga .env, peatage rakendus, laadige arhiiv ja käivitage rakendus seejärel uuesti:

Terminal, kaustas /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

Testisime kogu tsüklit oma VPS-is: varundus, andmebaasi tegelik kustutamine, taastamine. Monitor ja konto tulid tagasi ning sisselogimine toimis kohe uuesti.

Checkmate v4.0.0 pakub ka krüpteeritud pilvevarukoopiaid Checkmate Connecti kaudu. See on valikuline teenus, beetaperioodil tasuta, mis vajab paigalduse registreerimiseks ENCRYPTION_KEY-d ja Superadmini. Ülaltoodud koopiad toimivad ka ilma selleta.

Uuendused

Lugege versioonimärkmeid, tehke varukoopia, muutke tõmmise silti failis compose.yaml, seejärel tõmmake uus tõmmis ja looge konteiner uuesti. Andmebaasi migratsioonid käivituvad käivitamisel iseenesest:

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

Telemeetria

Checkmate saadab päevas ühe anonüümse aruande: paigalduse ID, versiooni, paigaldusviisi ja iga tüübi monitoride arvu, kuid mitte kunagi teie URL-e ega tulemusi. See teatab sellest käivitamisel oma logis. Selle väljalülitamiseks lisage TELEMETRY_ENABLED=false teenuse checkmate keskkonda ja käivitage seejärel docker compose up -d.

Kes mida teeb Managed VPS-is

Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; Checkmate jääb teie tarkvaraks oma monitoride ja teie sätetega.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudHetk, mis sobib teie tegevusele
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie enda monitorid, hoiatused ja olekulehed Checkmate’is
CheckmateProaktiivne jälgimine: vead, aeglus, andmebaas ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent
Kasutajad ja hoiatusedNeid kandev server, jälgitud ja varundatudKontod, rollid, kutsed ja teavituskanalid
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubCheckmate’i enda andmebaasi ekspordid ja taastamistaotlus, kui seda vajate
ÜleviimineTeie praeguse serveri üleviimine, tasutaÜmberlülitamise hetk

Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.

Checkmate teie eest hoitud serveris

Simafri Managed VPS-iga hoiavad meie meeskonnad teie Checkmate’i instantsi serveri ajakohasena, jälgivad seda päeval ja öösel ning sekkuvad ilma teie kõnet ootamata; nad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate ise või oma tehisintellekti assistendiga. Varukoopiad krüpteeritakse igal ööl ja hoitakse väljaspool masinat, nende taastamine sisaldub hinnas ning teie praeguse serveri üleviimine on tasuta.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas Checkmate on tasuta?

Jah. Checkmate on AGPL-3.0 litsentsiga: võite seda käitada enda, oma meeskonna või klientide jaoks, ilma et peaksite litsentsi ostma. Kui seda muudate ja lasete teistel seda võrgu kaudu kasutada, jagate oma muudatusi. Jääb ainult seda käitava serveri hind.

Kuidas paigaldada Checkmate Docker Compose’iga?

Kasutage viitefaili compose.yaml: tõmmis ghcr.io/bluewave-labs/checkmate ja MongoDB 8.0. Pange JWT_SECRET ja ENCRYPTION_KEY faili .env, määrake CLIENT_HOST oma https-aadressiks ja NODE_ENV väärtuseks production, avaldage port 52345 aadressil 127.0.0.1, käivitage docker compose up -d ja pange ette HTTPS-i pöördproksi.

Millised on Checkmate’i vaikimisi sisselogimisandmed?

Neid pole. Uues instantsis esimesena registreerunud inimesest saab Superadmin. Looge oma konto kohe pärast esimest käivitamist SSH-tunneli kaudu; seejärel suunatakse külastajad sisselogimislehele ja uued kasutajad liituvad kutse kaudu.

Kui palju mälu Checkmate vajab?

Dokumentatsioon nõuab Linuxi VPS-i, millel on 1 GB või rohkem RAM-i. Meie test-VPS-is kasutas värske paigaldus umbes 300 MB Checkmate’i ja 280 MB MongoDB jaoks. Kettamaht kasvab koos monitoride arvu, nende intervalli ja hoitava ajalooga, vaikimisi 90 päeva.

Kuidas saata Checkmate’i hoiatusi e-postiga?

Määrake SMTP-ühendus jaotise Settings vahekaardil Email: host, port 587 või 465, kasutaja, parool ja saatja, seejärel Save ja Test. Looge e-posti teavitus hoiatatavate aadressidega ja siduge see oma monitoridega. Kutsed kasutavad samu sätteid.

Kuidas Checkmate’i varundada?

Eksportige MongoDB andmebaas käsuga docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db ja hoidke alles koopia oma failist .env, mille ENCRYPTION_KEY on vajalik salvestatud saladuste lugemiseks. Taastage käsuga mongorestore --archive --gzip --drop, kui rakendus on peatatud.

Kuidas Checkmate’i uuendada?

Lugege versioonimärkmeid ja tehke varukoopia, muutke tõmmise silti failis compose.yaml, seejärel käivitage docker compose pull ja docker compose up -d. Andmebaasi migratsioonid käivituvad käivitamisel iseenesest.

Kas Managed VPS katab Checkmate’i?

Managed VPS katab serveri: süsteemi, turvalisuse, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad kasulikke parandusi, mille rakendate teie. Sekkumine rakendusse arveldatakse tunni- või kindlahinnaga.

Allikad ja ametlik dokumentatsioon

Võtke meiega ühendust