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.
Autorius: Simon Vasconcelos Lee
Paskelbta 2026 m. lapkričio 17 d.Skaitymo trukmė: 12 min.
ghcr.io/bluewave-labs/checkmate ir MongoDB 8.0, o prievadas paskelbtas adresu 127.0.0.1 už HTTPS atvirkštinio tarpinio serverio.JWT_SECRET, ENCRYPTION_KEY ir savo viešąjį adresą kintamajame CLIENT_HOST, taip pat pridėkite NODE_ENV=production, kurio pavyzdiniame faile nėra.mongodump ir išsaugokite savo .env failą, o atnaujinkite pakeisdami atvaizdo žymą: migracijos paleidžiamos savaime paleidimo metu.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.
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ų.
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į.
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ą:
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į:
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: pavyzdinis failas jį skelbia be adreso, ir tada Docker jį atveria visais serverio adresais. Paskelbtas lokaliai, jis pasiekiamas tik per atvirkštinį tarpinį serverį.CLIENT_HOST yra adresas, kurį įveda jūsų naudotojai, su https://. Checkmate jį naudoja kryžminės kilmės patikroms ir savo įspėjimų bei laiškų nuorodoms.NODE_ENV=production: README jo prašo realiuose diegimuose. Be jo programa veikia kūrimo režimu, kuris išjungia API užklausų ribotuvą.ENCRYPTION_KEY pavyzdiniame faile yra neprivalomas. Jis šifruoja Checkmate saugomas slaptas reikšmes, o v4.0.0 jo reikalauja Docker monitoriams per TLS ir Checkmate Connect. Nustatykite jį iš pat pradžių: tai paprasčiau nei pridėti vėliau.latest ir jį atsisiunčia kiekvieno paleidimo metu. Visa versija, čia v4.0.0, leidžia pasirinkti, kada vyks kiekvienas atnaujinimas.mongo-data saugo visus jūsų duomenis: monitorius, patikrinimus, naudotojus ir nustatymus.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:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate parodo savo registracijos puslapį.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ą.
| Vaidmuo | Ką jis gali daryti |
|---|---|
| User | Matyti visus monitorius, valdymo skydelį, patikrinimus, incidentus, būsenos puslapius ir nustatymus, nieko nekeisdamas |
| Admin | Viską, ką gali User, taip pat monitorius, pranešimų kanalus, incidentus, priežiūros langus, būsenos puslapius, kvietimus ir bendruosius nustatymus, įskaitant SMTP |
| Superadmin | Viską, 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.
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-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST turi būti tas pats https:// adresas kaip tarpinio serverio. Jį pakeitę, paleiskite docker compose up -d, kad konteineris būtų sukurtas iš naujo.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 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ą:
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.
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.
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:
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.
Tame pačiame ar naujame diegime, su tuo pačiu .env, sustabdykite programą, įkelkite archyvą, tada vėl ją paleiskite:
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.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump ir mongorestore. Jokio naujo aplinkos kintamojo nereikia.checkmate-client, checkmate-backend ir checkmate-mongo, kurie nebeatnaujinami. Pereikite prie ghcr.io/bluewave-labs/checkmate ir išlaikykite savo MongoDB paslaugą bei jos tomą; kintamieji UPTIME_APP_* nebeskaitomi.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.
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.
| Tema | Mūsų komandos | Jūs |
|---|---|---|
| Serveris | Sistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryje | Jūsų veiklai tinkamas momentas |
| Stebėsena | Serveris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučio | Jūsų pačių monitoriai, įspėjimai ir būsenos puslapiai Checkmate programoje |
| Checkmate | Proaktyvi stebėsena: klaidos, sulėtėjimai, duomenų bazė ir disko vieta pastebimi, rekomenduojamas pataisymas | Jos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas |
| Naudotojai ir įspėjimai | Juos nešantis serveris, stebimas ir saugomas atsarginėmis kopijomis | Paskyros, vaidmenys, kvietimai ir pranešimų kanalai |
| Atsarginės kopijos | Kiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotas | Pačios Checkmate duomenų bazės eksportai ir atkūrimo prašymas, kai jo prireikia |
| Perkėlimas | Jūsų dabartinis serveris perkeliamas nemokamai | Perjungimo 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ą.
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.
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.
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į.
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ą.
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ų.
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.
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.
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.
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.
Simafri
Pakalbėkime apie jūsų sumanymą
Pasakykite mums keliais žodžiais, ko jums reikia: greitai jums atsakome.
Ačiū! Jūsų užklausa išsiųsta. Netrukus su jumis susisieksime.
Labiau mėgstate el. paštą? Rašykite mums adresu support@simafri.com.