Хостване на Checkmate на Managed VPS: наблюдение на достъпността на ваш сървър

Хостването на Checkmate на Managed VPS означава, че наблюдението на сайтовете и сървърите ви остава на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Checkmate е свободно приложение с отворен код за мониторинг, с лиценз AGPL-3.0: достъпност, време за отговор, инциденти, известия и страници за състоянието. Това ръководство следва официалния му Docker образ във версия v4.0.0, а ние изпълнихме всяка команда на VPS на Simafri, преди да го напишем: инсталиране с Docker Compose, HTTPS, първият акаунт, мониторите и известията, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 17 ноември 2026 г.Време за четене: 12 минути

Всички ръководства

Накратко

  1. Лицензът AGPL-3.0 ви позволява да пускате Checkmate за себе си, за екипа си или за клиентите си, без да купувате лиценз; ако го промените и позволите на други да го използват през мрежата, споделяте промените си.
  2. Инсталирайте го с Docker Compose: универсалният образ ghcr.io/bluewave-labs/checkmate и MongoDB 8.0, с порта, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.
  3. Задайте JWT_SECRET, ENCRYPTION_KEY и публичния си адрес в CLIENT_HOST и добавете NODE_ENV=production, който референтният файл пропуска.
  4. Първият човек, който се регистрира, става Superadmin: създайте акаунта си веднага след първото стартиране, после всички останали се присъединяват с покана.
  5. Архивирайте базата данни MongoDB с mongodump и пазете файла си .env, после обновявайте, като смените етикета на образа: миграциите се изпълняват сами при стартиране.

Какво прави Checkmate

Checkmate проверява услугите ви на редовни интервали, записва всеки отговор и времето му за отговор и ви известява, когато нещо престане да отговаря. Разработчикът му, BlueWave Labs, го описва като инструмент за самостоятелно хостване, който следи в реално време хардуера на сървърите, достъпността, времето за отговор и инцидентите.

Какво позволява лицензът AGPL-3.0

Checkmate е публикуван с GNU Affero General Public License, версия 3 (AGPL-3.0). Можете да го използвате безплатно, за себе си, за фирмата си или за клиентите си, да го копирате и да го променяте.

Особената му клауза засяга използването през мрежа: ако промените Checkmate и позволите на други хора да използват променената ви версия през мрежата, трябва да им предложите изходния ѝ код. Пускането на официалния образ без промени, както в това ръководство, не създава такова задължение. Софтуерът се предоставя без гаранция.

Ресурсите, които да предвидите

Документацията поставя скромен минимум: всеки Linux VPS с 1 GB RAM или повече. Тя добавя, че MongoDB използва около 400 MB на инстанция, която проверява повече от 300 сървъра всяка минута.

Размерът на сървъра зависи следователно от броя на мониторите, интервала им и историята, която пазите. На Managed VPS ни разкажете как го използвате и ще ви препоръчаме подходящия размер.

Инсталиране с Docker Compose

От версия 3.10 Checkmate се доставя като един образ, ghcr.io/bluewave-labs/checkmate, който обслужва и интерфейса, и API. MongoDB работи до него, в собствен контейнер. На сървър с Docker Engine и неговия плъгин Compose, инсталирани от хранилището на Docker за Ubuntu, създайте папка като /opt/checkmate и поставете в нея този compose.yaml, базиран на референтния файл на проекта:

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, после стартирайте стека:

Терминал, в /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

Първото стартиране изпълнява миграциите на базата данни; на нашия тестов 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
  1. Отворете http://localhost:52345: Checkmate показва страницата си за регистрация.
  2. Въведете името, фамилията, имейл адреса си и парола от поне 8 знака, с главна буква, малка буква, цифра и специален знак.
  3. Регистрирайте се: попадате на таблото, влезли като Superadmin.

Оттук нататък публичната регистрация е затворена: на нашия тестов VPS всеки нов посетител беше пренасочван към страницата за вход, а адресът за регистрация също водеше там. Другите хора се присъединяват с покана, от раздела Team в настройките на акаунта, с ролята User или Admin. Поканата се изпраща по имейл, затова изисква настройките на SMTP по-долу, а връзката в нея изтича след един час.

РоляКакво може да прави
UserВижда всички монитори, таблото, проверките, инцидентите, страниците за състоянието и настройките, без да променя нищо
AdminВсичко, което може User, плюс мониторите, каналите за известия, инцидентите, прозорците за поддръжка, страниците за състоянието, поканите и глобалните настройки, включително SMTP
SuperadminВсичко, което може Admin, плюс прякото създаване на акаунти, редактирането на друг потребител, смяната на роля или на парола

От v4.0.0 етикетите, страниците за състоянието и проксито са действия на Admin: User, който можеше да ги управлява преди, губи този достъп след обновяването.

HTTPS: обратният прокси

Контейнерът обслужва Checkmate по HTTP, на порт 52345. HTTPS се поема от обратен прокси пред него: документацията посочва Caddy, Traefik и nginx. Ние тествахме Caddy, инсталиран от официалното му хранилище за Debian и Ubuntu: той сам получава сертификата Let’s Encrypt, подновява го и по подразбиране препраща заглавката Host и заглавките X-Forwarded-*.

/etc/caddy/Caddyfile
status.example.com {
	reverse_proxy 127.0.0.1:52345
}
Терминал
sudo systemctl reload caddy

Първият ви монитор и неговите известия

  1. В „Uptime“ щракнете върху „Create monitor“ и изберете HTTP/HTTPS.
  2. Въведете адреса за проверка, име, което ще разпознаете в известие, и интервал: документацията препоръчва от една до пет минути за критична услуга.
  3. Запазете: Checkmate изпълнява първата проверка веднага. На нашия тестов VPS мониторът беше в състояние up минута по-късно.

Имейл: настройките на SMTP

Известията по имейл и поканите минават през SMTP връзка, обща за целия сървър, зададена в „Settings“, раздел „Email“: хост, порт, потребител, парола и адрес на подателя, после „Save“ и „Test“. На VPS на Simafri използвайте SMTP сървър с удостоверяване на порт 587 или 465: пощенската услуга на домейна ви или услуга за изпращане. След това създайте известие по имейл с адресите, които да бъдат известявани, и го прикрепете към мониторите си.

Slack, Discord, Teams, Telegram и другите канали се създават по същия начин, в „Notifications“, всеки със своя webhook адрес или токен и всеки с бутон „Test“.

Мониторите heartbeat за планираните ви задачи

Мониторът heartbeat следи задача, която се изпълнява сама, като нощно резервно копие. Генерирайте ping ключа на екипа в „Settings“, раздел „Monitoring“ (той се показва само веднъж), създайте монитор Heartbeat със slug и прозорец за известяване, после извикайте неговия ping адрес в края на задачата:

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"

Добавянето на /fail или на кода за изход на задачата към адреса отбелязва монитора като down веднага, без да се чака прозорецът да изтече.

Страниците за състоянието

В „Status pages“ Admin публикува страница, която изброява избрани монитори и тяхната достъпност, за клиентите ви или за екипа ви. От v4.0.0 всяка страница за състоянието има часова зона, по подразбиране UTC.

Резервните копия

Всичко се намира на две места: базата данни MongoDB, в тома mongo-data, и файлът ви .env. Пазете последния на сигурно място: ENCRYPTION_KEY е нужен, за да се четат тайните, съхранени в базата данни, а JWT_SECRET поддържа потребителите ви влезли. Образът на MongoDB включва mongodump:

Терминал, в /opt/checkmate
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak

Планирайте това копие и го изпращайте извън сървъра; мониторът heartbeat може да ви съобщи, ако някога спре да се изпълнява. Поставени на диска, архивите влизат и в нощните резервни копия на сървъра.

Възстановяване

На същата или на нова инсталация, със същия .env, спрете приложението, заредете архива, после го стартирайте отново:

Терминал, в /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

Тествахме целия цикъл на нашия VPS: резервно копие, действително изтрита база данни, възстановяване. Мониторът и акаунтът се върнаха, а влизането отново заработи веднага.

Checkmate v4.0.0 предлага и шифровани резервни копия в облака чрез Checkmate Connect, незадължителна услуга, безплатна по време на бета версията, която изисква ENCRYPTION_KEY и Superadmin, за да регистрира инсталацията. Копията по-горе работят без нея.

Обновленията

Прочетете бележките към версията, направете резервно копие, сменете етикета на образа в compose.yaml, после изтеглете новия образ и пресъздайте контейнера. Миграциите на базата данни се изпълняват сами при стартиране:

Терминал, в /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Телеметрията

Checkmate изпраща по един анонимен отчет на ден: идентификатор на инсталацията, версията, начина на инсталиране и броя на мониторите от всеки тип, никога вашите адреси или резултати. Той го съобщава в журнала си при стартиране. За да я изключите, добавете TELEMETRY_ENABLED=false към средата на услугата checkmate, после изпълнете docker compose up -d.

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Checkmate остава ваш софтуер, с мониторите си и вашите настройки.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виВашите собствени монитори, известия и страници за състоянието в Checkmate
CheckmateПроактивно проследяване: грешки, забавяния, базата данни и дисковото пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент
Потребителите и известиятаСървърът, който ги носи, наблюдаван и архивиранАкаунтите, ролите, поканите и каналите за известия
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноЕкспортите на базата данни на самия Checkmate и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

Checkmate, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Checkmate, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е Checkmate?

Да. Checkmate е с лиценз AGPL-3.0: можете да го пускате за себе си, за екипа си или за клиентите си, без да купувате лиценз. Ако го промените и позволите на други да го използват през мрежата, споделяте промените си. Остава цената на сървъра, на който работи.

Как се инсталира Checkmate с Docker Compose?

Използвайте референтния 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.

Какви са данните за вход по подразбиране на Checkmate?

Няма такива. Първият човек, който се регистрира на нова инстанция, става Superadmin. Създайте акаунта си веднага след първото стартиране, през SSH тунел; след това посетителите се пренасочват към страницата за вход, а новите потребители се присъединяват с покана.

Колко памет е нужна на Checkmate?

Документацията изисква Linux VPS с 1 GB RAM или повече. На нашия тестов VPS нова инсталация използваше около 300 MB за Checkmate и 280 MB за MongoDB. Дискът расте с броя на мониторите, интервала им и историята, която пазите, по подразбиране 90 дни.

Как се изпращат известията на Checkmate по имейл?

Задайте SMTP връзката в Settings, раздел Email: хост, порт 587 или 465, потребител, парола и подател, после Save и Test. Създайте известие по имейл с адресите, които да бъдат известявани, и го прикрепете към мониторите си. Поканите използват същите настройки.

Как се архивира Checkmate?

Експортирайте базата данни MongoDB с docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db и пазете копие на файла си .env, чийто ENCRYPTION_KEY е нужен, за да се четат съхранените тайни. Възстановявайте с mongorestore --archive --gzip --drop, при спряно приложение.

Как се обновява Checkmate?

Прочетете бележките към версията и направете резервно копие, сменете етикета на образа в compose.yaml, после изпълнете docker compose pull и docker compose up -d. Миграциите на базата данни се изпълняват сами при стартиране.

Покрива ли Managed VPS Checkmate?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

Хостване на Uptime Kuma на Managed VPS: следете услугите си непрекъснатоХостването на Uptime Kuma на Managed VPS означава да следите сайтовете, API-тата и сървърите си от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Uptime Kuma е свободен софтуер с лиценз MIT. Това ръководство следва официалната му документация: инсталиране с Docker Compose, HTTPS, база данни, известия, резервни копия и обновления.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.Разлика между управляван и неуправляван VPS: кой какво правиРазликата между управляван и неуправляван VPS се свежда до един въпрос: кой се грижи за сървъра, след като той вече работи. Думата „управляван“ обаче няма официално определение и от един хостинг доставчик до друг обхваща всичко от простото инсталиране на системата до цялостното стопанисване на сървъра. Това ръководство показва кой какво прави, ред по ред, заедно с междинното ниво на експертното съдействие, и дава въпросите, които премахват двусмислието, преди да подпишете.
Свържете се с нас