Talpinkite Checkmate Managed VPS serveryje: pasiekiamumo stebėjimas

Checkmate talpinimas Managed VPS serveryje reiškia, kad jūsų svetainių ir serverių stebėjimas vyksta jūsų pačių mašinoje, kurią mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. Checkmate yra laisva atvirojo kodo stebėjimo programa, platinama pagal AGPL-3.0 licenciją: pasiekiamumas, atsako laikas, incidentai, įspėjimai ir būsenos puslapiai. Šis gidas seka oficialų jos Docker atvaizdą, v4.0.0 versiją, o kiekvieną komandą prieš rašydami išbandėme Simafri VPS serveryje: diegimą su Docker Compose, HTTPS, pirmąją paskyrą, monitorius ir įspėjimus, atsargines kopijas ir atnaujinimus.

Simon Vasconcelos Lee Autorius: Paskelbta 2026 m. lapkričio 17 d.Skaitymo trukmė: 12 min.

Visi gidai

Svarbiausia

  1. AGPL-3.0 licencija leidžia naudoti Checkmate sau, savo komandai ar klientams, nepirkus jokios licencijos; jei ją pakeičiate ir leidžiate kitiems ja naudotis per tinklą, pasidalijate savo pakeitimais.
  2. Įdiekite ją su Docker Compose: visa viename atvaizdas ghcr.io/bluewave-labs/checkmate ir MongoDB 8.0, o prievadas paskelbtas adresu 127.0.0.1 už HTTPS atvirkštinio tarpinio serverio.
  3. Nustatykite JWT_SECRET, ENCRYPTION_KEY ir savo viešąjį adresą kintamajame CLIENT_HOST, taip pat pridėkite NODE_ENV=production, kurio pavyzdiniame faile nėra.
  4. Pirmasis užsiregistravęs asmuo tampa Superadmin: susikurkite paskyrą iškart po pirmojo paleidimo, o visi kiti prisijungia pagal kvietimą.
  5. Kurkite MongoDB duomenų bazės atsargines kopijas su mongodump ir išsaugokite savo .env failą, o atnaujinkite pakeisdami atvaizdo žymą: migracijos paleidžiamos savaime paleidimo metu.

Ką daro Checkmate

Checkmate reguliariais intervalais tikrina jūsų paslaugas, įrašo kiekvieną atsakymą ir jo atsako laiką ir įspėja jus, kai kas nors nustoja atsakyti. Jos kūrėjas BlueWave Labs ją apibūdina kaip savarankiškai talpinamą įrankį, realiuoju laiku stebintį serverio aparatinę įrangą, pasiekiamumą, atsako laiką ir incidentus.

Ką leidžia AGPL-3.0 licencija

Checkmate platinama pagal GNU Affero General Public License 3 versiją (AGPL-3.0). Ją galite nemokamai naudoti sau, savo įmonei ar klientams, kopijuoti ir keisti.

Ypatinga jos sąlyga susijusi su naudojimu per tinklą: jei pakeičiate Checkmate ir leidžiate kitiems žmonėms per tinklą naudotis jūsų pakeista versija, turite jiems pasiūlyti jos išeities kodą. Nepakeisto oficialaus atvaizdo naudojimas, kaip šiame gide, tokios pareigos nesukuria. Programinė įranga teikiama be garantijų.

Kokių išteklių reikia

Dokumentacija nustato kuklią minimalią ribą: bet koks Linux VPS su 1 GB ar daugiau RAM. Ji priduria, kad egzemplioriuje, kuris kas minutę tikrina daugiau nei 300 serverių, MongoDB naudoja apie 400 MB.

Todėl serverio dydis priklauso nuo monitorių skaičiaus, jų intervalo ir saugomos istorijos. Naudojant Managed VPS, papasakokite mums, kaip ją naudojate, ir mes rekomenduosime tinkamą dydį.

Diegimas su Docker Compose

Nuo 3.10 versijos Checkmate pateikiama kaip vienas atvaizdas, ghcr.io/bluewave-labs/checkmate, teikiantis ir sąsają, ir API. MongoDB veikia šalia, savo konteineryje. Serveryje su Docker Engine ir jo Compose papildiniu, įdiegtais iš Docker saugyklos Ubuntu sistemai, sukurkite katalogą, pavyzdžiui, /opt/checkmate, ir įdėkite į jį šį compose.yaml, parengtą pagal projekto pavyzdinį failą:

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:

Dvi slaptos reikšmės dedamos šalia esančiame .env faile, kurį Docker Compose nuskaito savaime. Sukurkite jį taip, kad skaityti galėtų tik root, tada paleiskite rinkinį:

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

Pirmasis paleidimas paleidžia duomenų bazės migracijas; mūsų bandomajame VPS serveryje programa per mažiau nei dešimt sekundžių pranešė esanti sveika. Norėdami patikrinti, ar ji atsako:

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

Pirmoji komanda atsako 200. Antroji atsako "data":false, kol nėra nė vienos paskyros, ir true, kai Superadmin jau sukurtas.

Pirmoji paskyra, vaidmenys ir kvietimai

Checkmate neturi numatytosios paskyros. Pirmasis užsiregistravęs asmuo tampa Superadmin, todėl susikurkite savo paskyrą iškart po pirmojo paleidimo, prieš atverdami adresą visuomenei. SSH tunelis serverio 52345 prievadą atveda į jūsų kompiuterį, adresu http://localhost:52345; pridėkite -p ir SSH prievadą, nurodytą jūsų kliento zonoje.

Terminal, jūsų kompiuteryje
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Atidarykite http://localhost:52345: Checkmate parodo savo registracijos puslapį.
  2. Įveskite savo vardą, pavardę, el. pašto adresą ir bent 8 simbolių slaptažodį su didžiąja raide, mažąja raide, skaitmeniu ir specialiuoju simboliu.
  3. Užsiregistruokite: pateksite į valdymo skydelį, prisijungę kaip Superadmin.

Nuo tada vieša registracija uždaryta: mūsų bandomajame VPS serveryje kiekvienas naujas lankytojas buvo nukreiptas į prisijungimo puslapį, ir registracijos adresas taip pat vedė ten. Kiti prisijungia pagal kvietimą, iš paskyros nustatymų skilties Team, su vaidmeniu User arba Admin. Kvietimas siunčiamas el. paštu, todėl jam reikia toliau aprašytų SMTP nustatymų, o jo nuoroda galioja vieną valandą.

VaidmuoKą jis gali daryti
UserMatyti visus monitorius, valdymo skydelį, patikrinimus, incidentus, būsenos puslapius ir nustatymus, nieko nekeisdamas
AdminViską, ką gali User, taip pat monitorius, pranešimų kanalus, incidentus, priežiūros langus, būsenos puslapius, kvietimus ir bendruosius nustatymus, įskaitant SMTP
SuperadminViską, ką gali Admin, taip pat tiesiogiai kurti paskyras, redaguoti kitą naudotoją, keisti vaidmenį ar slaptažodį

Nuo v4.0.0 versijos žymos, būsenos puslapiai ir tarpiniai serveriai yra Admin veiksmai: User, kuris anksčiau galėjo juos tvarkyti, po atnaujinimo šią prieigą praranda.

HTTPS: atvirkštinis tarpinis serveris

Konteineris Checkmate teikia per HTTP, 52345 prievadu. HTTPS rūpinasi priešais jį stovintis atvirkštinis tarpinis serveris: dokumentacija mini Caddy, Traefik ir nginx. Išbandėme Caddy, įdiegtą iš jo oficialios Debian ir Ubuntu saugyklos: jis pats gauna Let’s Encrypt sertifikatą, jį atnaujina ir pagal numatymą perduoda antraštę Host bei antraštes X-Forwarded-*.

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

Pirmasis jūsų monitorius ir jo įspėjimai

  1. Skiltyje „Uptime“ spustelėkite „Create monitor“ ir pasirinkite HTTP/HTTPS.
  2. Įveskite tikrinamą adresą, pavadinimą, kurį atpažinsite įspėjime, ir intervalą: dokumentacija kritinei paslaugai rekomenduoja nuo vienos iki penkių minučių.
  3. Išsaugokite: Checkmate pirmąjį patikrinimą atlieka iškart. Mūsų bandomajame VPS serveryje po minutės monitorius rodė, kad paslauga veikia.

El. paštas: SMTP nustatymai

El. pašto įspėjimai ir kvietimai siunčiami per bendrą viso serverio SMTP ryšį, nustatomą skiltyje „Settings“, kortelėje „Email“: serveris, prievadas, naudotojas, slaptažodis ir siuntėjo adresas, tada „Save“ ir „Test“. Simafri VPS serveryje naudokite SMTP serverį su autentifikavimu, 587 arba 465 prievadu: jūsų domeno pašto paslaugą arba siuntimo paslaugą. Tada sukurkite el. pašto pranešimą su adresais, kuriuos reikia įspėti, ir priskirkite jį savo monitoriams.

Slack, Discord, Teams, Telegram ir kiti kanalai kuriami taip pat, skiltyje „Notifications“, kiekvienas su savo webhook adresu ar žetonu ir kiekvienas su mygtuku „Test“.

Heartbeat monitoriai jūsų suplanuotoms užduotims

Heartbeat monitorius stebi užduotį, kuri vykdoma savaime, pavyzdžiui, naktinį atsarginį kopijavimą. Skiltyje „Settings“, kortelėje „Monitoring“, sugeneruokite komandos ping raktą (jis rodomas tik vieną kartą), sukurkite Heartbeat monitorių su trumpuoju pavadinimu (slug) ir įspėjimo langu, tada užduoties pabaigoje kreipkitės į jo ping URL adresą:

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"

Prie URL adreso pridėjus /fail arba užduoties išėjimo kodą, monitorius iškart pažymimas kaip neveikiantis, nelaukiant, kol praeis langas.

Būsenos puslapiai

Skiltyje „Status pages“ Admin paskelbia puslapį, kuriame išvardyti pasirinkti monitoriai ir jų pasiekiamumas, jūsų klientams ar komandai. Nuo v4.0.0 versijos kiekvienas būsenos puslapis turi laiko juostą, pagal numatymą UTC.

Atsarginės kopijos

Viskas yra dviejose vietose: MongoDB duomenų bazėje, tome mongo-data, ir jūsų .env faile. Pastarąjį laikykite saugiai: ENCRYPTION_KEY reikalingas duomenų bazėje saugomoms slaptoms reikšmėms perskaityti, o JWT_SECRET išlaiko jūsų naudotojus prisijungusius. MongoDB atvaizde yra mongodump:

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

Suplanuokite šią kopiją ir siųskite ją už serverio ribų; Heartbeat monitorius gali jums pranešti, jei ji kada nors nustotų vykti. Laikomi diske, archyvai taip pat patenka į naktines serverio atsargines kopijas.

Atkūrimas

Tame pačiame ar naujame diegime, su tuo pačiu .env, sustabdykite programą, įkelkite archyvą, tada vėl ją paleiskite:

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

Visą ciklą išbandėme savo VPS serveryje: atsarginė kopija, tikrai ištrinta duomenų bazė, atkūrimas. Monitorius ir paskyra sugrįžo, o prisijungimas iškart vėl veikė.

Checkmate v4.0.0 taip pat siūlo šifruotas debesijos atsargines kopijas per Checkmate Connect, neprivalomą paslaugą, nemokamą beta laikotarpiu, kuriai reikia ENCRYPTION_KEY ir Superadmin, kad diegimas būtų užregistruotas. Aukščiau aprašytos kopijos veikia ir be jos.

Atnaujinimai

Perskaitykite versijos pastabas, padarykite atsarginę kopiją, pakeiskite atvaizdo žymą faile compose.yaml, tada atsisiųskite naują atvaizdą ir iš naujo sukurkite konteinerį. Duomenų bazės migracijos paleidžiamos savaime paleidimo metu:

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

Telemetrija

Checkmate kartą per dieną siunčia vieną anoniminę ataskaitą: diegimo ID, versiją, diegimo būdą ir kiekvieno tipo monitorių skaičių, bet niekada jūsų URL adresų ar rezultatų. Ji apie tai praneša savo žurnale paleidimo metu. Norėdami tai išjungti, į paslaugos checkmate aplinką pridėkite TELEMETRY_ENABLED=false, tada paleiskite docker compose up -d.

Kas ką daro Managed VPS serveryje

Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Checkmate lieka jūsų programa su savo monitoriais ir jūsų nustatymais.

TemaMūsų komandosJūs
ServerisSistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryjeJūsų veiklai tinkamas momentas
StebėsenaServeris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučioJūsų pačių monitoriai, įspėjimai ir būsenos puslapiai Checkmate programoje
CheckmateProaktyvi stebėsena: klaidos, sulėtėjimai, duomenų bazė ir disko vieta pastebimi, rekomenduojamas pataisymasJos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas
Naudotojai ir įspėjimaiJuos nešantis serveris, stebimas ir saugomas atsarginėmis kopijomisPaskyros, vaidmenys, kvietimai ir pranešimų kanalai
Atsarginės kopijosKiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotasPačios Checkmate duomenų bazės eksportai ir atkūrimo prašymas, kai jo prireikia
PerkėlimasJūsų dabartinis serveris perkeliamas nemokamaiPerjungimo momentas

Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.

Checkmate serveryje, kurį prižiūrime už jus

Su Simafri Managed VPS mūsų komandos palaiko jūsų Checkmate egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.

Žiūrėti Managed VPS

Dažni klausimai

Ar Checkmate nemokama?

Taip. Checkmate platinama pagal AGPL-3.0 licenciją: ją galite naudoti sau, savo komandai ar klientams, nieko nepirkdami dėl licencijos. Jei ją pakeičiate ir leidžiate kitiems ja naudotis per tinklą, pasidalijate savo pakeitimais. Lieka tik ją vykdančio serverio kaina.

Kaip įdiegti Checkmate su Docker Compose?

Naudokite pavyzdinį compose.yaml: atvaizdas ghcr.io/bluewave-labs/checkmate ir MongoDB 8.0. JWT_SECRET ir ENCRYPTION_KEY įrašykite į .env failą, CLIENT_HOST nustatykite į savo https adresą, o NODE_ENV į production, paskelbkite 52345 prievadą adresu 127.0.0.1, paleiskite docker compose up -d ir priešais pastatykite HTTPS atvirkštinį tarpinį serverį.

Kokie yra numatytieji Checkmate prisijungimo duomenys?

Jų nėra. Pirmasis naujame egzemplioriuje užsiregistravęs asmuo tampa Superadmin. Susikurkite paskyrą iškart po pirmojo paleidimo, per SSH tunelį; vėliau lankytojai nukreipiami į prisijungimo puslapį, o nauji naudotojai prisijungia pagal kvietimą.

Kiek atminties reikia Checkmate?

Dokumentacija reikalauja Linux VPS su 1 GB ar daugiau RAM. Mūsų bandomajame VPS serveryje naujas diegimas naudojo apie 300 MB Checkmate ir 280 MB MongoDB. Disko poreikis auga kartu su monitorių skaičiumi, jų intervalu ir saugoma istorija, pagal numatymą 90 dienų.

Kaip siųsti Checkmate įspėjimus el. paštu?

Nustatykite SMTP ryšį skiltyje Settings, kortelėje Email: serveris, 587 arba 465 prievadas, naudotojas, slaptažodis ir siuntėjas, tada Save ir Test. Sukurkite el. pašto pranešimą su adresais, kuriuos reikia įspėti, ir priskirkite jį savo monitoriams. Kvietimai naudoja tuos pačius nustatymus.

Kaip sukurti Checkmate atsarginę kopiją?

Eksportuokite MongoDB duomenų bazę komanda docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db ir išsaugokite savo .env failo kopiją, nes jo ENCRYPTION_KEY reikalingas saugomoms slaptoms reikšmėms perskaityti. Atkurkite su mongorestore --archive --gzip --drop, kai programa sustabdyta.

Kaip atnaujinti Checkmate?

Perskaitykite versijos pastabas ir padarykite atsarginę kopiją, pakeiskite atvaizdo žymą faile compose.yaml, tada paleiskite docker compose pull ir docker compose up -d. Duomenų bazės migracijos paleidžiamos savaime paleidimo metu.

Ar Managed VPS apima Checkmate?

Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Įsikišimas į pačią programą apmokestinamas valandomis arba fiksuota kaina.

Šaltiniai ir oficiali dokumentacija

Susisiekite su mumis