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.
Autor: Simon Vasconcelos Lee
Avaldatud 17. novembril 2026Lugemisaeg: 12 minutit
ghcr.io/bluewave-labs/checkmate ja MongoDB 8.0, port avaldatud aadressil 127.0.0.1 HTTPS-i pöördproksi taga.JWT_SECRET, ENCRYPTION_KEY ja oma avalik aadress muutujas CLIENT_HOST ning lisage NODE_ENV=production, mis viitefailist puudub.mongodump ja hoidke alles oma fail .env, seejärel uuendage, muutes tõmmise silti: migratsioonid käivituvad käivitamisel iseenesest.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.
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.
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.
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:
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:
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: viitefail avaldab selle ilma aadressita ja Docker avab selle siis serveri kõigil aadressidel. Kohalikult avaldatuna on see kättesaadav ainult pöördproksi kaudu.CLIENT_HOST on aadress, mille teie kasutajad sisestavad, kujul https://. Checkmate kasutab seda päritoluüleste kontrollide jaoks ning oma hoiatuste ja e-kirjade linkides.NODE_ENV=production: README nõuab seda päris paigaldustes. Ilma selleta töötab rakendus arendusrežiimis, mis lülitab välja API päringupiiraja.ENCRYPTION_KEY on viitefailis valikuline. See krüpteerib Checkmate’i salvestatud saladused ning v4.0.0 nõuab seda TLS-iga Dockeri monitoride ja Checkmate Connecti jaoks. Määrake see kohe alguses: see on lihtsam kui selle hilisem lisamine.latest ja tõmbab selle iga käivitamisel. Täielik versioon, siin v4.0.0, laseb teil iga uuenduse aja ise valida.mongo-data hoiab kõiki teie andmeid: monitore, kontrolle, kasutajaid ja sätteid.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:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate näitab oma registreerumislehte.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.
| Roll | Mida see võimaldab |
|---|---|
| User | Näha kõiki monitore, juhtpaneeli, kontrolle, intsidente, olekulehti ja sätteid, ilma midagi muutmata |
| Admin | Kõike, mida User, lisaks monitorid, teavituskanalid, intsidendid, hooldusaknad, olekulehed, kutsed ja üldsätted, SMTP kaasa arvatud |
| Superadmin | Kõ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.
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-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST peab sisaldama sama https:// aadressi mis proksi. Pärast selle muutmist käivitage docker compose up -d, et konteiner uuesti luua.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-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:
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.
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.
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:
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.
Samas või uues paigalduses, sama failiga .env, peatage rakendus, laadige arhiiv ja käivitage rakendus seejärel uuesti:
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.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump ja mongorestore. Uut keskkonnamuutujat pole vaja.checkmate-client, checkmate-backend ja checkmate-mongo, mida enam ei uuendata. Minge üle tõmmisele ghcr.io/bluewave-labs/checkmate ning hoidke alles oma MongoDB teenus ja selle köide; muutujaid UPTIME_APP_* enam ei loeta.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.
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.
| Teema | Meie meeskonnad | Teie |
|---|---|---|
| Server | Süsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatud | Hetk, mis sobib teie tegevusele |
| Seire | Serverit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamata | Teie enda monitorid, hoiatused ja olekulehed Checkmate’is |
| Checkmate | Proaktiivne jälgimine: vead, aeglus, andmebaas ja kettaruum avastatakse, parandus soovitatakse | Selle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent |
| Kasutajad ja hoiatused | Neid kandev server, jälgitud ja varundatud | Kontod, rollid, kutsed ja teavituskanalid |
| Varukoopiad | Igal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldub | Checkmate’i enda andmebaasi ekspordid ja taastamistaotlus, kui seda vajate |
| Üleviimine | Teie 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Räägime teie kavatsusest
Öelge meile paari sõnaga, mida vajate: vastame teile kiiresti.
Aitäh! Teie päring on saadetud. Võtame teiega peagi ühendust.
Eelistate e-posti? Kirjutage meile aadressil support@simafri.com.