Uptime Kuma: мониторинг сайтов на своём VPS

Self-hosted сервисы
Uptime Kuma: мониторинг сайтов на своём VPS

Когда сайт падает, узнать об этом хочется раньше клиентов, а не из гневного письма. Uptime Kuma — это самостоятельный монитор доступности с приятным интерфейсом, который проверяет ваши сервисы по расписанию и шлёт уведомления в Telegram, почту или мессенджеры. Разберём, как выглядит uptime kuma установка на собственном VPS: поднимем сервис в Docker, настроим первые проверки и сделаем публичную статус-страницу. В итоге вы получите полноценный мониторинг аптайма без абонентской платы за чужой сервис.

Что умеет Uptime Kuma

Uptime Kuma — открытый проект, который часто называют самостоятельной заменой платным сервисам мониторинга. Он написан на Node.js, работает из одного контейнера и хранит данные в SQLite, поэтому запускается буквально за минуту. Интерфейс живой и понятный: графики отклика, история инцидентов и наглядные индикаторы состояния.

Основные возможности:

  • Проверки по HTTP(S), TCP-порту, пингу, DNS и даже по ключевым словам на странице.
  • Гибкий интервал опроса и настройка числа повторов перед объявлением сбоя.
  • Более 90 способов уведомлений: Telegram, e-mail, Slack, вебхуки и другие.
  • Публичные статус-страницы, которые можно показать пользователям.
  • Учёт SSL-сертификатов с предупреждением о скором истечении.

Ресурсов сервису нужно немного, поэтому он отлично живёт на NAT VPS с общим IPv4 и проброшенными портами. Мониторинг создаёт мало трафика, а закрытый на NAT-тарифах порт 25 ему не мешает — уведомления идут через Telegram или внешний SMTP по портам 465 и 587.

Подготовка сервера

Понадобится VPS с Linux и установленным Docker. Если планируете открыть доступ к панели по домену и HTTPS (а это желательно), заранее направьте поддомен на IP сервера — например, status.example.com.

Что нужноЗачем
VPS с LinuxХостинг мониторинга
Docker и ComposeЗапуск контейнера
ПоддоменДоступ к панели и статус-странице по HTTPS
Reverse proxyТерминация TLS

Если Docker ещё не установлен, начните со статьи Docker на VPS, а затем возвращайтесь сюда.

Шаг 1. Готовим docker-compose.yml

Создадим директорию проекта и опишем сервис. Данные вынесем в отдельный том, чтобы они пережили пересоздание контейнера.

# Каталог под проект
mkdir -p /opt/uptime-kuma
cd /opt/uptime-kuma
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    volumes:
      # Здесь хранятся база и настройки
      - ./data:/app/data
    ports:
      # Наружу не открываем — пустим через reverse proxy
      - "127.0.0.1:3001:3001"

Порт привязан к 127.0.0.1, чтобы панель не была доступна из интернета напрямую. Весь внешний трафик пойдёт через reverse proxy с TLS, а сам сервис останется на локальном интерфейсе.

Шаг 2. Запускаем контейнер

# Поднимаем сервис в фоне
docker compose up -d

# Проверяем состояние
docker compose ps

# Читаем логи запуска
docker compose logs -f uptime-kuma

Через несколько секунд сервис будет доступен локально на порту 3001. Про структуру compose-файлов и типовые приёмы работы со стеками читайте в материале Docker Compose на практике.

Шаг 3. Reverse proxy и HTTPS

Панель управления мониторингом стоит закрыть шифрованием — через неё проходят адреса и настройки ваших сервисов. Uptime Kuma использует веб-сокеты, поэтому в конфиге Nginx важно прокинуть соответствующие заголовки.

server {
    listen 443 ssl http2;
    server_name status.example.com;

    ssl_certificate     /etc/letsencrypt/live/status.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/status.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;

        # Обязательные заголовки для веб-сокетов
        proxy_set_header Upgrade    $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_set_header Host            $host;
        proxy_set_header X-Real-IP       $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
# Проверяем конфиг и перечитываем Nginx
nginx -t && systemctl reload nginx

Выпуск и автопродление сертификата подробно описаны в статье SSL-сертификат Let's Encrypt. Если за одним доменом у вас несколько сервисов, пригодится схема из материала Nginx как reverse proxy.

Шаг 4. Первый вход и создание админа

Откройте https://status.example.com. При первом запуске Uptime Kuma попросит создать учётную запись администратора — задайте логин и надёжный пароль. Отдельного шага с регистрацией новых пользователей тут нет, панель одноадминная, что упрощает жизнь.

После входа вы попадёте на пустой дашборд. Отсюда добавляются мониторы, настраиваются уведомления и собираются статус-страницы.

Шаг 5. Добавляем первую проверку

Нажмите «Add New Monitor» и заполните параметры. Для типового сайта подойдут такие настройки:

  1. Тип монитора — HTTP(s).
  2. Имя — понятное название, например «Основной сайт».
  3. URL — полный адрес, включая https://.
  4. Интервал проверки — 60 секунд для боевых сервисов.
  5. Число повторов (Retries) — 2–3, чтобы разовый таймаут не поднимал ложную тревогу.

Для проверки не просто кода ответа, а содержимого страницы выберите тип «HTTP(s) - Keyword» и укажите слово, которое должно присутствовать в ответе. Так вы поймаете ситуацию, когда сервер отдаёт 200, но страница на самом деле сломана.

Кроме сайтов полезно мониторить и инфраструктуру: TCP-порт базы данных, доступность SSH или собственные сервисы. Например, стоит следить за Gitea — своим Git-сервером, чтобы вовремя узнавать о проблемах с ним.

Шаг 6. Настраиваем уведомления в Telegram

Самый удобный канал оповещений — Telegram. Сначала создайте бота через @BotFather и получите токен, затем узнайте свой chat_id.

# Узнаём chat_id: напишите боту любое сообщение, затем выполните запрос
curl -s "https://api.telegram.org/bot<ВАШ_ТОКЕН>/getUpdates"

В ответе найдите поле chat.id — это и есть нужное число. Дальше в интерфейсе Uptime Kuma:

  1. Откройте Settings → Notifications → Setup Notification.
  2. Выберите тип Telegram.
  3. Вставьте токен бота и chat_id.
  4. Нажмите «Test» — бот пришлёт пробное сообщение.
  5. Привяжите уведомление ко всем мониторам.

Теперь при падении любого сервиса вы получите сообщение в течение минуты, а при восстановлении — оповещение о том, что всё снова работает.

Шаг 7. Публичная статус-страница

Если хочется показать пользователям состояние сервисов, соберите статус-страницу. В разделе «Status Pages» создайте новую страницу, выберите нужные мониторы и настройте оформление. Получится публичный адрес, где видно текущее состояние и историю аптайма без доступа к самой панели.

Такая страница удобна для команды и клиентов: вместо звонков «у вас лежит?» они сами заглядывают на статус. При этом настройки мониторов и токены остаются скрытыми — наружу отдаётся только состояние.

Обслуживание и обновление

Обновляется сервис заменой образа. Перед этим сделайте бэкап каталога data.

# Обновляем образ и пересоздаём контейнер
docker compose pull
docker compose up -d

Резервную копию проще всего снять с тома data — там лежит вся база с историей и настройками. Настроить регулярное копирование по расписанию поможет статья Резервное копирование VPS. Держите хотя бы одну копию вне сервера, чтобы не потерять историю мониторинга при сбое.

Частые вопросы

Чем Uptime Kuma лучше платных сервисов мониторинга?

Главное отличие — данные и уведомления полностью под вашим контролем, без ежемесячной платы и лимитов на число проверок. Интерфейс не уступает облачным аналогам: графики отклика, история инцидентов, статус-страницы и десятки каналов оповещений. Платить нужно только за небольшой VPS, на котором всё это крутится.

Потянет ли NAT VPS такой мониторинг?

Да, легко. Uptime Kuma нетребователен к ресурсам и создаёт минимум трафика, поэтому NAT Base от Cheap-Host с проброшенными портами полностью подходит. Закрытый на NAT-тарифах порт 25 не помеха: уведомления удобнее слать через Telegram или внешний SMTP по портам 465 и 587.

Можно ли мониторить сервисы за фаерволом или в локальной сети?

Uptime Kuma проверяет то, до чего дотягивается сам сервер. Если целевой сервис доступен только внутри приватной сети, поднимите VPN между машинами — например, по инструкции WireGuard на VPS. Тогда монитор сможет опрашивать внутренние адреса через туннель.

Почему приходят ложные срабатывания?

Чаще всего причина — слишком агрессивный интервал и отсутствие повторов. Поставьте Retries равным 2–3, чтобы одиночный сетевой таймаут не поднимал тревогу. Также проверьте, что интервал проверки адекватен: 60 секунд достаточно для большинства сайтов.

Как не потерять историю мониторинга?

Вся история хранится в SQLite внутри тома data. Регулярно копируйте этот каталог в надёжное место и держите копию вне сервера. Тогда даже при переустановке или сбое диска вы восстановите и настройки мониторов, и накопленную статистику.

Поднимите свой мониторинг за минуту

Uptime Kuma — это тот редкий инструмент, который ставится за пару команд и сразу приносит пользу. Для него хватает NAT Base с общим IPv4 и проброшенными портами: сервис лёгкий, а вы всегда знаете, что происходит с вашими сайтами. Выберите тариф на Cheap-Host, поднимите контейнер по шагам выше и настройте оповещения, чтобы узнавать о сбоях первым.

Читайте также