Mitināt Checkmate Managed VPS serverī nozīmē uzraudzīt savas tīmekļa vietnes un serverus no savas pašu mašīnas, ko mūsu komandas uztur atjauninātu un uzrauga dienu un nakti. Checkmate ir brīva atvērtā koda uzraudzības lietotne ar AGPL-3.0 licenci: pieejamība, atbildes laiki, incidenti, brīdinājumi un statusa lapas. Šis ceļvedis seko tās oficiālajam Docker attēlam versijā v4.0.0, un pirms tā rakstīšanas mēs izpildījām katru komandu Simafri VPS serverī: uzstādīšana ar Docker Compose, HTTPS, pirmais konts, monitori un brīdinājumi, rezerves kopijas un atjauninājumi.
Autors: Simon Vasconcelos Lee
Publicēts 2026. gada 17. novembrīLasīšanas laiks: 12 minūtes
ghcr.io/bluewave-labs/checkmate un MongoDB 8.0, ar portu, publicētu uz 127.0.0.1 aiz HTTPS reversā starpniekservera.JWT_SECRET, ENCRYPTION_KEY un savu publisko adresi mainīgajā CLIENT_HOST, kā arī pievienojiet NODE_ENV=production, ko atsauces fails neiekļauj.mongodump un saglabājiet savu .env failu, bet atjauniniet, nomainot attēla birku: migrācijas palaižas pašas startēšanas laikā.Checkmate regulāri pārbauda jūsu pakalpojumus, reģistrē katru atbildi un tās atbildes laiku un brīdina jūs, kad kaut kas pārstāj atbildēt. Tā izstrādātājs BlueWave Labs to raksturo kā pašmitinātu rīku servera aparatūras, pieejamības, atbildes laiku un incidentu izsekošanai reāllaikā.
Checkmate tiek publicēts ar GNU Affero General Public License, 3. versiju (AGPL-3.0). Varat to izmantot bez maksas, sev, savam uzņēmumam vai saviem klientiem, kopēt un mainīt.
Tās īpašā klauzula attiecas uz lietošanu tīklā: ja maināt Checkmate un ļaujat citiem cilvēkiem izmantot savu mainīto versiju tīklā, jums jāpiedāvā viņiem tās pirmkods. Oficiālā attēla darbināšana bez izmaiņām, kā šajā ceļvedī, šādu pienākumu nerada. Programmatūra tiek nodrošināta bez garantijas.
Dokumentācija nosaka pieticīgu minimumu: jebkurš Linux VPS ar 1 GB RAM vai vairāk. Tā piebilst, ka MongoDB izmanto aptuveni 400 MB instancē, kas katru minūti pārbauda vairāk nekā 300 serverus.
Tāpēc servera izmērs ir atkarīgs no monitoru skaita, to intervāla un glabātās vēstures. Ar Managed VPS pastāstiet mums, kā to izmantojat, un mēs ieteiksim piemērotu izmēru.
Kopš versijas 3.10 Checkmate tiek piegādāts kā viens attēls, ghcr.io/bluewave-labs/checkmate, kas pasniedz gan saskarni, gan API. MongoDB darbojas blakus, savā konteinerā. Serverī ar Docker Engine un tā Compose spraudni, kas uzstādīti no Docker repozitorija Ubuntu sistēmai, izveidojiet mapi, piemēram, /opt/checkmate, un ievietojiet tajā šo compose.yaml, kas balstīts uz projekta atsauces failu:
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:
Abas slepenās vērtības nonāk blakus esošā .env failā, ko Docker Compose nolasa pats. Izveidojiet to lasāmu tikai root lietotājam, pēc tam palaidiet steku:
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: atsauces fails to publicē bez adreses, un tad Docker to atver visās servera adresēs. Publicēts lokāli, tas ir sasniedzams tikai caur reverso starpniekserveri.CLIENT_HOST ir adrese, ko ieraksta jūsu lietotāji, ar https://. Checkmate to izmanto starpdomēnu (cross-origin) pārbaudēm un saitēm savos brīdinājumos un e-pastos.NODE_ENV=production: README to pieprasa reālās izvietošanās. Bez tā lietotne darbojas izstrādes režīmā, kas izslēdz API pieprasījumu biežuma ierobežotāju.ENCRYPTION_KEY atsauces failā nav obligāts. Tas šifrē slepenās vērtības, ko Checkmate glabā, un versijai v4.0.0 tas vajadzīgs TLS Docker monitoriem un Checkmate Connect. Iestatiet to jau no sākuma: tas ir vienkāršāk nekā pievienot vēlāk.latest un lejupielādē to katrā palaišanā. Pilna versija, šeit v4.0.0, ļauj izvēlēties, kad notiek katrs atjauninājums.mongo-data glabā visus jūsu datus: monitorus, pārbaudes, lietotājus un iestatījumus.Pirmā palaišana izpilda datubāzes migrācijas; mūsu testa VPS serverī lietotne mazāk nekā desmit sekundēs ziņoja, ka ir veselā stāvoklī. Lai pārbaudītu, vai tā atbild:
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
Pirmā komanda atbild 200. Otrā atbild "data":false, kamēr neviens konts nepastāv, un true, tiklīdz Superadmin ir izveidots.
Checkmate nav noklusējuma konta. Pirmā persona, kas reģistrējas, kļūst par Superadmin, tāpēc izveidojiet savu kontu tūlīt pēc pirmās palaišanas, pirms atverat adresi publikai. SSH tunelis atved servera portu 52345 uz jūsu datoru, adresē http://localhost:52345; pievienojiet -p un SSH portu, kas norādīts jūsu klienta zonā.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate parāda savu reģistrācijas lapu.No šī brīža publiskā reģistrācija ir aizvērta: mūsu testa VPS serverī katrs jauns apmeklētājs tika novirzīts uz pieteikšanās lapu, un turp veda arī reģistrācijas adrese. Citi cilvēki pievienojas ar ielūgumu no konta iestatījumu sadaļas Team, ar lomu User vai Admin. Ielūgums tiek nosūtīts pa e-pastu, tāpēc tam vajadzīgi tālāk aprakstītie SMTP iestatījumi, un tā saite zaudē derīgumu pēc vienas stundas.
| Loma | Ko tā var darīt |
|---|---|
| User | Redzēt visus monitorus, informācijas paneli, pārbaudes, incidentus, statusa lapas un iestatījumus, neko nemainot |
| Admin | Visu, ko var User, un papildus: monitori, paziņojumu kanāli, incidenti, apkopes logi, statusa lapas, ielūgumi un globālie iestatījumi, ieskaitot SMTP |
| Superadmin | Visu, ko var Admin, un papildus: kontu tieša izveide, cita lietotāja rediģēšana, lomas vai paroles maiņa |
Kopš v4.0.0 birkas, statusa lapas un starpniekserveri ir Admin darbības: User, kurš tos varēja pārvaldīt agrāk, pēc atjauninājuma šo piekļuvi zaudē.
Konteiners pasniedz Checkmate pa HTTP, portā 52345. Par HTTPS rūpējas reversais starpniekserveris, kas atrodas tā priekšā: dokumentācija nosauc Caddy, Traefik un nginx. Mēs testējām Caddy, kas uzstādīts no tā oficiālā Debian un Ubuntu repozitorija: tas pats iegūst Let’s Encrypt sertifikātu, to atjauno un pēc noklusējuma pārsūta galveni Host un galvenes X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST jāsatur tā pati https:// adrese, kas starpniekserverim. Pēc tās maiņas palaidiet docker compose up -d, lai no jauna izveidotu konteineru.E-pasta brīdinājumi un ielūgumi tiek sūtīti caur visam serverim kopīgu SMTP savienojumu, ko iestata sadaļā «Settings», cilnē «Email»: resursdators, ports, lietotājs, parole un sūtītāja adrese, pēc tam «Save» un «Test». Simafri VPS serverī izmantojiet SMTP serveri ar autentifikāciju, portā 587 vai 465: jūsu domēna pasta pakalpojumu vai sūtīšanas pakalpojumu. Pēc tam izveidojiet e-pasta paziņojumu ar brīdināmajām adresēm un piesaistiet to saviem monitoriem.
Slack, Discord, Teams, Telegram un pārējos kanālus izveido tāpat, sadaļā «Notifications», katru ar tā webhook adresi vai pilnvaru un katru ar pogu «Test».
Heartbeat monitors uzrauga uzdevumu, kas darbojas pats, piemēram, nakts rezerves kopēšanu. Ģenerējiet komandas ping atslēgu sadaļā «Settings», cilnē «Monitoring» (tā tiek parādīta tikai vienu reizi), izveidojiet Heartbeat monitoru ar slug identifikatoru un brīdinājuma logu, pēc tam uzdevuma beigās izsauciet tā ping URL:
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"
Ja URL pievieno /fail vai uzdevuma izejas kodu, monitors uzreiz tiek atzīmēts kā nedarbojošs, negaidot, kamēr logs paiet.
Sadaļā «Status pages» Admin publicē lapu, kurā uzskaitīti izvēlēti monitori un to pieejamība, jūsu klientiem vai jūsu komandai. Kopš v4.0.0 katrai statusa lapai ir laika josla, pēc noklusējuma UTC.
Viss atrodas divās vietās: MongoDB datubāzē, sējumā mongo-data, un jūsu .env failā. Glabājiet šo failu drošībā: ENCRYPTION_KEY vajadzīgs, lai nolasītu datubāzē glabātās slepenās vērtības, un JWT_SECRET uztur jūsu lietotājus pieteiktus. MongoDB attēlā ir iekļauts mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
Ieplānojiet šo kopēšanu un sūtiet kopijas ārpus servera; heartbeat monitors var jums paziņot, ja tā kādreiz pārstāj darboties. Glabāti servera diskā, arhīvi tiek iekļauti arī tā nakts rezerves kopijās.
Tajā pašā vai jaunā uzstādījumā, ar to pašu .env, apturiet lietotni, ielādējiet arhīvu, pēc tam palaidiet to atkal:
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate
Mēs testējām visu ciklu savā VPS serverī: rezerves kopija, patiešām izdzēsta datubāze, atjaunošana. Monitors un konts atgriezās, un pieteikšanās uzreiz atkal darbojās.
Checkmate v4.0.0 piedāvā arī šifrētas rezerves kopijas mākonī caur Checkmate Connect, neobligātu pakalpojumu, kas beta versijas laikā ir bez maksas un kam vajadzīgs ENCRYPTION_KEY un Superadmin, lai reģistrētu instalāciju. Iepriekš minētās kopijas darbojas bez tā.
Izlasiet versijas piezīmes, izveidojiet rezerves kopiju, nomainiet attēla birku failā compose.yaml, pēc tam lejupielādējiet jauno attēlu un no jauna izveidojiet konteineru. Datubāzes migrācijas palaižas pašas startēšanas laikā:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump un mongorestore. Neviens jauns vides mainīgais nav obligāts.checkmate-client, checkmate-backend un checkmate-mongo, kas vairs netiek atjaunināti. Pārejiet uz ghcr.io/bluewave-labs/checkmate un saglabājiet savu MongoDB pakalpojumu un tā sējumu; mainīgie UPTIME_APP_* vairs netiek nolasīti.Checkmate sūta vienu anonīmu atskaiti dienā: instalācijas ID, versiju, uzstādīšanas veidu un katra veida monitoru skaitu, nekad jūsu URL vai rezultātus. Tas par to paziņo savā žurnālā startēšanas laikā. Lai to izslēgtu, pievienojiet TELEMETRY_ENABLED=false pakalpojuma checkmate videi, pēc tam palaidiet docker compose up -d.
Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; Checkmate paliek jūsu programmatūra ar saviem monitoriem un jūsu iestatījumiem.
| Temats | Mūsu komandas | Jūs |
|---|---|---|
| Serveris | Sistēmas un drošības atjauninājumi, ieskaitot iejaukšanos serverī | Brīdis, kas der jūsu darbam |
| Uzraudzība | Serveris tiek uzraudzīts 24/7, iejaucoties, negaidot jūsu zvanu | Jūsu pašu monitori, brīdinājumi un statusa lapas Checkmate |
| Checkmate | Proaktīva sekošana: kļūdas, palēninājumi, datubāze un diska vieta tiek pamanīti, labojums tiek ieteikts | Tā uzstādīšana, atjauninājumi un iestatījumi, ko ieviešat jūs vai jūsu MI asistents |
| Lietotāji un brīdinājumi | Serveris, kas tos nes, uzraudzīts un ar rezerves kopijām | Konti, lomas, ielūgumi un paziņojumu kanāli |
| Rezerves kopijas | Katru nakti, šifrētas un glabātas ārpus mašīnas; atjaunošana iekļauta | Paša Checkmate datubāzes eksporti un atjaunošanas pieprasījums, kad tas vajadzīgs |
| Migrācija | Jūsu pašreizējā servera migrācija, bez maksas | Pārslēgšanās brīdis |
Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.
Ar Simafri Managed VPS mūsu komandas uztur jūsu Checkmate instances serveri atjauninātu, uzrauga to dienu un nakti un iejaucas, negaidot jūsu zvanu; tās arī proaktīvi seko jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs paši vai jūsu MI asistents. Rezerves kopijas katru nakti tiek šifrētas un glabātas ārpus mašīnas, to atjaunošana ir iekļauta, un jūsu pašreizējā servera migrācija ir bez maksas.
Jā. Checkmate ir ar AGPL-3.0 licenci: varat to darbināt sev, savai komandai vai saviem klientiem, nepērkot nekādu licenci. Ja to maināt un ļaujat citiem to izmantot tīklā, jūs dalāties ar savām izmaiņām. Paliek tikai servera izmaksas, uz kura tas darbojas.
Izmantojiet atsauces compose.yaml: attēls ghcr.io/bluewave-labs/checkmate un MongoDB 8.0. Ierakstiet JWT_SECRET un ENCRYPTION_KEY .env failā, iestatiet CLIENT_HOST uz savu https adresi un NODE_ENV uz production, publicējiet portu 52345 uz 127.0.0.1, palaidiet docker compose up -d un novietojiet priekšā HTTPS reverso starpniekserveri.
Tādu nav. Pirmā persona, kas reģistrējas jaunā instancē, kļūst par Superadmin. Izveidojiet savu kontu tūlīt pēc pirmās palaišanas, caur SSH tuneli; pēc tam apmeklētāji tiek novirzīti uz pieteikšanās lapu, un jauni lietotāji pievienojas ar ielūgumu.
Dokumentācija prasa Linux VPS ar 1 GB RAM vai vairāk. Mūsu testa VPS serverī jauna instalācija izmantoja aptuveni 300 MB Checkmate un 280 MB MongoDB. Diska vajadzība aug līdz ar monitoru skaitu, to intervālu un glabāto vēsturi, pēc noklusējuma 90 dienas.
Iestatiet SMTP savienojumu sadaļā Settings, cilnē Email: resursdators, ports 587 vai 465, lietotājs, parole un sūtītājs, pēc tam Save un Test. Izveidojiet e-pasta paziņojumu ar brīdināmajām adresēm un piesaistiet to saviem monitoriem. Ielūgumi izmanto tos pašus iestatījumus.
Eksportējiet MongoDB datubāzi ar docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db un saglabājiet sava .env faila kopiju, jo tajā esošais ENCRYPTION_KEY vajadzīgs glabāto slepeno vērtību nolasīšanai. Atjaunojiet ar mongorestore --archive --gzip --drop, kamēr lietotne ir apturēta.
Izlasiet versijas piezīmes un izveidojiet rezerves kopiju, nomainiet attēla birku failā compose.yaml, pēc tam palaidiet docker compose pull un docker compose up -d. Datubāzes migrācijas palaižas pašas startēšanas laikā.
Managed VPS aptver serveri: sistēmu, drošību, uzraudzību un rezerves kopijas. Mūsu komandas proaktīvi seko arī jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs. Iejaukšanās lietojumprogrammā tiek rēķināta par stundu vai par fiksētu summu.
Simafri
Parunāsim par jūsu ieceri
Pasakiet mums dažos vārdos, kas jums vajadzīgs: mēs jums ātri atbildam.
Paldies! Jūsu pieprasījums ir nosūtīts. Drīzumā ar jums sazināsimies.
Labāk e-pastu? Rakstiet mums uz support@simafri.com.