Хостване на Uptime Kuma на Managed VPS: следете услугите си непрекъснато

Какво следи Uptime Kuma

Uptime Kuma проверява услугите ви на равни интервали, до една проверка на всеки 20 секунди, пази историята на отговорите им и ви уведомява веднага щом някоя от тях спре да отговаря. Използва се през уеб интерфейс, наличен на няколко езика.

• Проверките: HTTP и HTTPS, търсене на ключова дума в страницата, JSON заявка, TCP, WebSocket, ping, DNS запис, Docker контейнери и проверка „push“ за планирана задача, която сама съобщава, че е минала.
• Известията: над 90 услуги за известяване, сред които Telegram, Discord, Slack и имейл.
• Страниците със състояние: няколко публични страници, всяка на собствен домейн, ако желаете.
• Сертификатите: данните за HTTPS сертификата на всяка следена услуга.
• Акаунтът: двуфакторно удостоверяване и преминаване през прокси за проверките, които имат нужда от това.

Поставете Uptime Kuma на друг сървър, различен от услугите, които следи. На отделна машина той вижда аварията отвън и изпраща известието, докато услугите ви са спрени.

Какво позволява лицензът MIT

Uptime Kuma е публикуван с лиценз MIT. Той разрешава да използвате, копирате, променяте, обединявате, публикувате, разпространявате, преотстъпвате и продавате софтуера, при едно условие: да запазите бележката за авторските права и текста на лиценза във всяко копие.

Можете следователно да пускате Uptime Kuma във фирма, да следите с него услугите на клиентите си и да им отваряте страници със състояние, без да купувате лиценз.

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

Документацията на Uptime Kuma започва с Docker Compose. На сървър с инсталиран Docker създайте папка и изтеглете официалния файл:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Файлът на проекта публикува порт 3001 на всички адреси на сървъра. Зад обратен прокси го ограничете до локалния адрес, както предлага README:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

• Порт, публикуван на 127.0.0.1: по подразбиране Docker публикува на всички адреси на сървъра, преди правилата на защитната стена ufw. Локално Uptime Kuma е достъпен само през обратния прокси.
• Папка data на локален диск: тя пази базата kuma.db, изпратените файлове и снимките на екрана. Проектът не препоръчва NFS и другите мрежови файлови системи, защото SQLite има нужда от надеждни заключвания на файлове.
• Етикетът 2 следва версия 2 на Uptime Kuma, а преминаването към следваща основна версия остава ваш избор.
• Образът 2-slim е по-лек, около 185 MB за изтегляне срещу 620 MB: той оставя настрана Chromium и вградения MariaDB, които носи образът 2. Образът 2 е този, който проектът препоръчва, а проверка „Browser Engine“ изисква външен Chromium с 2-slim.

При първото стартиране отворете интерфейса: помощник ви кара да изберете базата данни, а после да създадете администраторския акаунт. Включете двуфакторното удостоверяване още при първото влизане.

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

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

В обществена мрежа проектът изисква HTTPS. Uptime Kuma се основава на WebSocket: обратният прокси трябва да предава заглавките Upgrade и Connection. Предоставя се в корена на домейн или поддомейн, а уикито му отхвърля подпапките като example.com/uptimekuma.

С Caddy

Caddy сам получава и подновява сертификата и предава WebSocket без допълнителна настройка:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

С Nginx и Certbot

server {
    listen 80;
    server_name uptime.example.com;

    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
    }
}

След това Certbot поставя сертификата Let’s Encrypt и пренасочването към HTTPS, а после сам подновява сертификата:

sudo certbot --nginx -d uptime.example.com

Когато Uptime Kuma е достъпен само през прокси, отворете настройките му, „Settings“, „Reverse Proxy“, „HTTP Headers“, и сменете „Trust Proxy“ на „Yes“: тогава журналите показват истинския адрес на посетителите.

SQLite или MariaDB

От версия 2 Uptime Kuma предлага три бази данни, които избирате в помощника при първото стартиране:

За да фиксирате избора предварително, без да минавате през помощника, променливите UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME и UPTIME_KUMA_DB_PASSWORD се добавят към услугата в compose.yaml.

Известията, включително по имейл

Проверката има смисъл само ако известието стигне до вас. Декларирайте каналите си в „Settings“, „Notifications“, изпратете пробно съобщение от всеки от тях и осигурете два, например месинджър и имейл: ако единият спре, другият поема.

За имейл Uptime Kuma се свързва със SMTP сървър. На VPS на Simafri изпращането минава през удостоверено реле, на порт 587: адресът на пощенски акаунт, който вече имате, или Simafri Suite.

Резервни копия и обновления

От версия 2 архивирането на папката data е единственият метод, който проектът поддържа. Със SQLite или с вградения MariaDB всичко се съдържа там. SQLite база, копирана по време на запис, може да се повреди: спрете контейнера за времето на копирането, като знаете, че проверките спират заедно с него.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Обновяване

Уикито на проекта дава две команди, от папката на compose.yaml. Папката data остава на мястото си:

docker compose pull
docker compose up -d --force-recreate

Прочитайте бележките към версията преди всяко обновяване: някои съдържат поправки за сигурността, като 2.5.9 от 31 октомври 2026 г. Резервно копие непосредствено преди това ви дава лесен начин за връщане назад.

Преминаването от версия 1 към версия 2 изисква повече внимание: архивирайте папката data при спрян контейнер и оставете миграцията да стигне до края, защото прекъсната миграция налага възстановяване на резервното копие. Проектът е отчел около 7 минути за 20 проверки и 90 дни история, и много повече на скромна машина или с повече проверки.

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

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

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