Хостването на Checkmate на Managed VPS означава, че наблюдението на сайтовете и сървърите ви остава на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Checkmate е свободно приложение с отворен код за мониторинг, с лиценз AGPL-3.0: достъпност, време за отговор, инциденти, известия и страници за състоянието. Това ръководство следва официалния му Docker образ във версия v4.0.0, а ние изпълнихме всяка команда на VPS на Simafri, преди да го напишем: инсталиране с Docker Compose, HTTPS, първият акаунт, мониторите и известията, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 17 ноември 2026 г.Време за четене: 12 минути
ghcr.io/bluewave-labs/checkmate и MongoDB 8.0, с порта, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.JWT_SECRET, ENCRYPTION_KEY и публичния си адрес в CLIENT_HOST и добавете NODE_ENV=production, който референтният файл пропуска.mongodump и пазете файла си .env, после обновявайте, като смените етикета на образа: миграциите се изпълняват сами при стартиране.Checkmate проверява услугите ви на редовни интервали, записва всеки отговор и времето му за отговор и ви известява, когато нещо престане да отговаря. Разработчикът му, BlueWave Labs, го описва като инструмент за самостоятелно хостване, който следи в реално време хардуера на сървърите, достъпността, времето за отговор и инцидентите.
Checkmate е публикуван с GNU Affero General Public License, версия 3 (AGPL-3.0). Можете да го използвате безплатно, за себе си, за фирмата си или за клиентите си, да го копирате и да го променяте.
Особената му клауза засяга използването през мрежа: ако промените Checkmate и позволите на други хора да използват променената ви версия през мрежата, трябва да им предложите изходния ѝ код. Пускането на официалния образ без промени, както в това ръководство, не създава такова задължение. Софтуерът се предоставя без гаранция.
Документацията поставя скромен минимум: всеки Linux VPS с 1 GB RAM или повече. Тя добавя, че MongoDB използва около 400 MB на инстанция, която проверява повече от 300 сървъра всяка минута.
Размерът на сървъра зависи следователно от броя на мониторите, интервала им и историята, която пазите. На Managed VPS ни разкажете как го използвате и ще ви препоръчаме подходящия размер.
От версия 3.10 Checkmate се доставя като един образ, ghcr.io/bluewave-labs/checkmate, който обслужва и интерфейса, и API. MongoDB работи до него, в собствен контейнер. На сървър с Docker Engine и неговия плъгин Compose, инсталирани от хранилището на Docker за Ubuntu, създайте папка като /opt/checkmate и поставете в нея този 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:
Двете тайни отиват във файл .env до него, който Docker Compose чете сам. Създайте го четим само за root, после стартирайте стека:
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: референтният файл го публикува без адрес, а тогава Docker го отваря на всички адреси на сървъра. Публикуван локално, той е достъпен само през обратния прокси.CLIENT_HOST е адресът, който потребителите ви въвеждат, с https://. Checkmate го използва за проверките на кръстосания произход (cross-origin) и за връзките в известията и имейлите си.NODE_ENV=production: README го изисква при реални внедрявания. Без него приложението работи в режим на разработка, който изключва ограничителя на заявките към API.ENCRYPTION_KEY е незадължителен в референтния файл. Той шифрова тайните, които Checkmate съхранява, а v4.0.0 го изисква за мониторите на Docker през TLS и за Checkmate Connect. Задайте го от самото начало: така е по-лесно, отколкото да го добавяте по-късно.latest и го изтегля при всяко стартиране. Пълната версия, тук v4.0.0, ви позволява да изберете кога да стане всяко обновяване.mongo-data пази всичките ви данни: монитори, проверки, потребители и настройки.Първото стартиране изпълнява миграциите на базата данни; на нашия тестов VPS приложението съобщи, че е в изправност, за по-малко от десет секунди. За да проверите дали отговаря:
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
Първата команда отговаря с 200. Втората отговаря с "data":false, докато не съществува акаунт, и с true, щом Superadmin бъде създаден.
Checkmate няма акаунт по подразбиране. Първият човек, който се регистрира, става Superadmin, затова създайте своя веднага след първото стартиране, преди да отворите адреса за публиката. SSH тунел довежда порт 52345 на сървъра до вашия компютър, на http://localhost:52345; добавете -p и SSH порта, показан в клиентската ви зона.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate показва страницата си за регистрация.Оттук нататък публичната регистрация е затворена: на нашия тестов VPS всеки нов посетител беше пренасочван към страницата за вход, а адресът за регистрация също водеше там. Другите хора се присъединяват с покана, от раздела Team в настройките на акаунта, с ролята User или Admin. Поканата се изпраща по имейл, затова изисква настройките на SMTP по-долу, а връзката в нея изтича след един час.
| Роля | Какво може да прави |
|---|---|
| User | Вижда всички монитори, таблото, проверките, инцидентите, страниците за състоянието и настройките, без да променя нищо |
| Admin | Всичко, което може User, плюс мониторите, каналите за известия, инцидентите, прозорците за поддръжка, страниците за състоянието, поканите и глобалните настройки, включително SMTP |
| Superadmin | Всичко, което може Admin, плюс прякото създаване на акаунти, редактирането на друг потребител, смяната на роля или на парола |
От v4.0.0 етикетите, страниците за състоянието и проксито са действия на Admin: User, който можеше да ги управлява преди, губи този достъп след обновяването.
Контейнерът обслужва Checkmate по HTTP, на порт 52345. HTTPS се поема от обратен прокси пред него: документацията посочва Caddy, Traefik и nginx. Ние тествахме Caddy, инсталиран от официалното му хранилище за Debian и Ubuntu: той сам получава сертификата Let’s Encrypt, подновява го и по подразбиране препраща заглавката Host и заглавките X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST трябва да съдържа същия адрес с https:// като проксито. След като го промените, изпълнете docker compose up -d, за да пресъздадете контейнера.Известията по имейл и поканите минават през SMTP връзка, обща за целия сървър, зададена в „Settings“, раздел „Email“: хост, порт, потребител, парола и адрес на подателя, после „Save“ и „Test“. На VPS на Simafri използвайте SMTP сървър с удостоверяване на порт 587 или 465: пощенската услуга на домейна ви или услуга за изпращане. След това създайте известие по имейл с адресите, които да бъдат известявани, и го прикрепете към мониторите си.
Slack, Discord, Teams, Telegram и другите канали се създават по същия начин, в „Notifications“, всеки със своя webhook адрес или токен и всеки с бутон „Test“.
Мониторът heartbeat следи задача, която се изпълнява сама, като нощно резервно копие. Генерирайте ping ключа на екипа в „Settings“, раздел „Monitoring“ (той се показва само веднъж), създайте монитор Heartbeat със slug и прозорец за известяване, после извикайте неговия ping адрес в края на задачата:
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"
Добавянето на /fail или на кода за изход на задачата към адреса отбелязва монитора като down веднага, без да се чака прозорецът да изтече.
В „Status pages“ Admin публикува страница, която изброява избрани монитори и тяхната достъпност, за клиентите ви или за екипа ви. От v4.0.0 всяка страница за състоянието има часова зона, по подразбиране UTC.
Всичко се намира на две места: базата данни MongoDB, в тома mongo-data, и файлът ви .env. Пазете последния на сигурно място: ENCRYPTION_KEY е нужен, за да се четат тайните, съхранени в базата данни, а JWT_SECRET поддържа потребителите ви влезли. Образът на MongoDB включва mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
Планирайте това копие и го изпращайте извън сървъра; мониторът heartbeat може да ви съобщи, ако някога спре да се изпълнява. Поставени на диска, архивите влизат и в нощните резервни копия на сървъра.
На същата или на нова инсталация, със същия .env, спрете приложението, заредете архива, после го стартирайте отново:
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate
Тествахме целия цикъл на нашия VPS: резервно копие, действително изтрита база данни, възстановяване. Мониторът и акаунтът се върнаха, а влизането отново заработи веднага.
Checkmate v4.0.0 предлага и шифровани резервни копия в облака чрез Checkmate Connect, незадължителна услуга, безплатна по време на бета версията, която изисква ENCRYPTION_KEY и Superadmin, за да регистрира инсталацията. Копията по-горе работят без нея.
Прочетете бележките към версията, направете резервно копие, сменете етикета на образа в compose.yaml, после изтеглете новия образ и пресъздайте контейнера. Миграциите на базата данни се изпълняват сами при стартиране:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump и mongorestore. Не се изисква нова променлива на средата.checkmate-client, checkmate-backend и checkmate-mongo, които вече не се обновяват. Преминете към ghcr.io/bluewave-labs/checkmate и запазете услугата си MongoDB и нейния том; променливите UPTIME_APP_* вече не се четат.Checkmate изпраща по един анонимен отчет на ден: идентификатор на инсталацията, версията, начина на инсталиране и броя на мониторите от всеки тип, никога вашите адреси или резултати. Той го съобщава в журнала си при стартиране. За да я изключите, добавете TELEMETRY_ENABLED=false към средата на услугата checkmate, после изпълнете docker compose up -d.
Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Checkmate остава ваш софтуер, с мониторите си и вашите настройки.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Вашите собствени монитори, известия и страници за състоянието в Checkmate |
| Checkmate | Проактивно проследяване: грешки, забавяния, базата данни и дисковото пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент |
| Потребителите и известията | Сървърът, който ги носи, наблюдаван и архивиран | Акаунтите, ролите, поканите и каналите за известия |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Експортите на базата данни на самия Checkmate и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Checkmate, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. Checkmate е с лиценз AGPL-3.0: можете да го пускате за себе си, за екипа си или за клиентите си, без да купувате лиценз. Ако го промените и позволите на други да го използват през мрежата, споделяте промените си. Остава цената на сървъра, на който работи.
Използвайте референтния compose.yaml: образа ghcr.io/bluewave-labs/checkmate и MongoDB 8.0. Поставете JWT_SECRET и ENCRYPTION_KEY във файл .env, задайте CLIENT_HOST на адреса си с https и NODE_ENV на production, публикувайте порт 52345 на 127.0.0.1, изпълнете docker compose up -d и поставете пред него обратен прокси с HTTPS.
Няма такива. Първият човек, който се регистрира на нова инстанция, става Superadmin. Създайте акаунта си веднага след първото стартиране, през SSH тунел; след това посетителите се пренасочват към страницата за вход, а новите потребители се присъединяват с покана.
Документацията изисква Linux VPS с 1 GB RAM или повече. На нашия тестов VPS нова инсталация използваше около 300 MB за Checkmate и 280 MB за MongoDB. Дискът расте с броя на мониторите, интервала им и историята, която пазите, по подразбиране 90 дни.
Задайте SMTP връзката в Settings, раздел Email: хост, порт 587 или 465, потребител, парола и подател, после Save и Test. Създайте известие по имейл с адресите, които да бъдат известявани, и го прикрепете към мониторите си. Поканите използват същите настройки.
Експортирайте базата данни MongoDB с docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db и пазете копие на файла си .env, чийто ENCRYPTION_KEY е нужен, за да се четат съхранените тайни. Възстановявайте с mongorestore --archive --gzip --drop, при спряно приложение.
Прочетете бележките към версията и направете резервно копие, сменете етикета на образа в compose.yaml, после изпълнете docker compose pull и docker compose up -d. Миграциите на базата данни се изпълняват сами при стартиране.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.