Если ваш сайт или онлайн-сервис время от времени перестаёт открываться, вы рискуете узнать об этом не от системы, а от недовольных посетителей. Чтобы предупреждать сбои заранее, используют мониторинг — автоматическую проверку доступности ресурсов. Бесплатный инструмент Uptime Kuma позволяет поднять собственную систему мониторинга на виртуальном сервере и получать оповещения в Telegram, на почту или в мессенджер. В этой статье по шагам разберём, как настроить Uptime Kuma на VPS, что для этого понадобится и как не наступить на типичные грабли.
Зачем нужен мониторинг
Мониторинг доступности решает простую, но важную задачу: он вовремя сообщает, что сайт, API или веб-приложение перестали отвечать. Для интернет-магазина даже десять минут простоя означают потерянные заказы, для корпоративного портала — сорванные рабочие процессы. Ручная проверка «в лоб» не подходит, ведь сбои часто случаются ночью или в выходные. Система мониторинга следит за состоянием ресурса круглосуточно и уведомляет вас первым делом, когда появляется проблема.
Платная система мониторинга обычно берёт абонентскую плату за каждый проверяемый узел. Если вам нужно следить за двумя-тремя сайтами, можно сэкономить, развернув open-source решение на собственном VPS. Uptime Kuma — один из самых удобных вариантов: у него простая веб-панель, много типов проверок и десятки способов уведомлений. При этом все данные хранятся на вашем сервере, а не на чужих машинах.
Основные понятия
Прежде чем переходить к настройке, уточним термины, которые будем использовать.
- VPS (Virtual Private Server) — виртуальный сервер с собственным IP-адресом, операционной системой и полным доступом. Вы можете устанавливать на него любые программы, как на обычный компьютер.
- Аптайм (uptime) — процент времени, в течение которого сервис был доступен. Например, аптайм 99,9 % означает, что за год сервис простаивал не больше 8,7 часов.
- Мониторинг — регулярные проверки доступности ресурса по заданному сценарию: отправка HTTP-запроса, ping, проверка порта и так далее.
- Uptime Kuma — приложение с открытым исходным кодом, которое предоставляет веб-интерфейс для настройки проверок, отображает историю доступности и отправляет уведомления.
- Docker — технология для запуска приложений в изолированных контейнерах. Контейнер включает саму программу и все её зависимости, поэтому вам не придётся вручную устанавливать нужные библиотеки.
Весь процесс настройки Uptime Kuma можно уложить в несколько этапов: подготовка сервера, запуск контейнера, создание администратора и добавление первого монитора. Рассмотрим каждый из них.
Установка и настройка Uptime Kuma на VPS
Шаг 1. Подготовка VPS-сервера
Uptime Kuma довольно легковесен, поэтому для его работы хватит VPS с 1 виртуальным ядром, 1 ГБ оперативной памяти и диском от 20 ГБ. Такой конфигурации достаточно и для самого приложения, и для системы, и для хранения базы данных. Если вы планируете проверять много сервисов с интервалом в 10–15 секунд, лучше взять 2 vCPU и 2 ГБ RAM — запас не помешает.
Операционную систему выбирайте Ubuntu 22.04 или Debian 11/12: на них проще всего установить Docker и запустить контейнер. Арендовать подходящий тариф можно в Serverspace — например, на странице аренды VPS-серверов. Там есть посуточная оплата и удобная панель управления, в которой можно открывать нужные порты.
После создания сервера подключитесь к нему по SSH (в Linux/macOS — из терминала командой ssh root@IP, в Windows — через PuTTY) и выполните обновление пакетов:
sudo apt update && sudo apt upgrade -y
Если используется файрвол, убедитесь, что он разрешает подключения по SSH (обычно порт 22) и не блокирует другие порты до определённого момента.
Шаг 2. Установка Docker
Uptime Kuma распространяется в виде Docker-образа, поэтому сначала поставим сам Docker. Есть официальный скрипт установки, но мы используем стандартный репозиторий Ubuntu. Выполните команды:
sudo apt install -y docker.io
sudo systemctl enable --now docker
Проверьте, что служба запущена:
sudo systemctl status docker
Впрочем, можно установить Docker Engine с официального сайта Docker — но для обычного пользователя достаточно пакета docker.io из репозитория Ubuntu.
Если вы работаете не от root, добавьте своего пользователя в группу docker, чтобы не вводить sudo для каждой команды Docker. Если вы вошли как root, этот шаг можно пропустить:
sudo usermod -aG docker $USER
После этого нужно перезайти по SSH (или выполнить newgrp docker).
Шаг 3. Запуск Uptime Kuma
Создайте каталог для данных приложения и запустите контейнер:
mkdir -p /opt/uptime-kuma
docker run -d \
--name uptime-kuma \
-p 3001:3001 \
-v /opt/uptime-kuma:/app/data \
--restart unless-stopped \
louislam/uptime-kuma
Разберём, что делает эта команда:
- -d — запустить контейнер в фоновом режиме;
- --name uptime-kuma — задать имя контейнера;
- -p 3001:3001 — пробросить порт 3001 с хоста в контейнер, чтобы веб-интерфейс был доступен извне;
- -v /opt/uptime-kuma:/app/data — сохранять данные приложения в каталоге /opt/uptime-kuma на сервере, иначе они пропадут при пересоздании контейнера;
- --restart unless-stopped — автоматически перезапускать контейнер после сбоя или перезагрузки сервера;
- louislam/uptime-kuma — официальный образ из Docker Hub.
После запуска откройте в панели управления сервером порт 3001 (или разрешите его в файрволе командой sudo ufw allow 3001/tcp). Затем в браузере перейдите по адресу http://IP_вашего_сервера:3001. Откроется страница создания администратора: придумайте логин и пароль. Обязательно сохраните их в менеджере паролей — восстановить доступ без потери данных будет сложно.
Шаг 4. Добавление мониторов
После входа в панель вы увидите пустой интерфейс. Нажмите «Add New Monitor» (Добавить новый монитор), чтобы создать первую проверку. В настройках обратите внимание на основные поля:
- Monitor Type (Тип проверки) — выбираете, каким способом будет проверяться ресурс.
- URL или Host — адрес проверяемого сайта или IP.
- Interval (Интервал) — как часто отправлять запрос. Для сайтов разумно ставить 60 секунд.
- Retries (Повторные попытки) — сколько раз подряд проверка должна завершиться неудачей, прежде чем зафиксировать инцидент.
- Notification — список уведомлений, которые будут срабатывать для этого монитора.
Типов проверок в Uptime Kuma несколько, и для разных задач подходят разные. Собрали их в таблицу.
| Тип проверки | Что делает | Типичный сценарий |
|---|---|---|
| HTTP(s) | Отправляет GET-запрос по указанному URL и проверяет код ответа, время загрузки и заголовки | Проверка доступности главной страницы сайта, API-эндпоинта |
| Ping | Отправляет ICMP-запросы хосту | Проверка, что сервер в сети вообще отвечает, даже не по HTTP |
| TCP | Открывает TCP-соединение с указанным хостом и портом | Проверка работы SSH (22), базы данных (5432), почтового сервера (25, 587) |
| SSL Certificate | Показывает, сколько дней осталось до истечения SSL-сертификата | Предупреждение о том, что пора продлить сертификат, за 30–60 дней |
| Keyword | Ищет заданную строку в ответе страницы | Проверка, что на странице отображается «Форма заказа», «Успешно» и т. п. |
Допустим, вам нужно следить за интернет-магазином example.ru. Выберите тип HTTP(s), укажите https://example.ru, интервал 60 секунд и повторные попытки 2. Uptime Kuma будет каждую минуту заходить на сайт, и если два раза подряд не получит нормальный ответ (например, коды 5xx или таймаут), система зафиксирует инцидент и отправит уведомление.
Шаг 5. Настройка уведомлений
В Uptime Kuma множество способов уведомлений: Telegram, Discord, Slack, почта по SMTP, Webhook и другие. Покажем на примере Telegram.
Перейдите в раздел Notifications (Уведомления) в профиле пользователя или в настройках монитора. Нажмите «Add Notification», выберите тип Telegram. Понадобится:
- Bot Token (токен бота) — вы получите его у @BotFather в Telegram, создав бота.
- Chat ID (идентификатор чата) — куда бот будет отправлять сообщения. Можно узнать с помощью специальных ботов (например, @userinfobot) или через API Telegram (метод getUpdates).
Сохраните настройки и отправьте тестовое сообщение. Если в указанный чат пришла проверка, значит всё работает.
Для каждого монитора можно выбрать конкретные уведомления: например, о сбое сайта отправлять в Telegram, а о проблемах с SSL — только на почту. Так вы не заспамите себя лишними сообщениями.
Плюсы и минусы Uptime Kuma
У любого инструмента есть сильные и слабые стороны. Uptime Kuma не исключение.
Преимущества:
- Бесплатно. Никакой подписки и ограничений по количеству мониторов.
- Открытый код. Вы можете просмотреть исходники, найти уязвимости, доработать под себя.
- Много типов проверок. HTTP, ping, TCP, SSL, DNS и другие.
- Гибкие уведомления. Десятки каналов, в том числе популярные мессенджеры.
- Собственные серверы. Данные о проверках хранятся у вас, а не в чужом облаке.
- Статус-страница. Можно включить публичную страницу, на которой посетители видят статус всех сервисов.
Недостатки и ограничения:
- Нужен VPS. Uptime Kuma не работает на бесплатном хостинге для статических сайтов. Минимальная стоимость сервера — от нескольких сотен рублей в месяц.
- Техническое обслуживание. Придётся самостоятельно обновлять Docker-образ, следить за свободным местом на диске и иногда разбирать ошибки.
- Единая точка отказа. Если сам VPS станет недоступен, мониторинг не пришлёт уведомление. Для критичного бизнеса имеет смысл подстраховаться вторым Uptime Kuma на другом сервере.
- Задержка уведомлений. Между сбоем и отправкой сообщения пройдёт время, равное интервалу проверки плюс повторным попыткам. При интервале 60 секунд и двух попытках — до трёх минут.
Типовые сценарии использования
- Мониторинг личного блога. У вас небольшой сайт на WordPress. Создаёте монитор HTTP(s) для главной страницы, ставите интервал 5 минут и спокойно работаете. При сбое придёт уведомление в Telegram, и вы успеете среагировать до прихода посетителей.
- Контроль API для мобильного приложения. Разработчики часто используют Uptime Kuma для проверки бэкенда. Например, можно настроить проверку конкретного эндпоинта /health и получать сигнал, если ответ пришёл со статусом 500. Это удобно при командной разработке и проведении релизов.
- Слежение за SSL-сертификатом. Внезапно истекший сертификат — одна из самых частых причин «упавшего» сайта. Благодаря типу проверки SSL Certificate вы получите предупреждение за месяц до истечения срока. Укажите адрес проверяемого сайта, и Uptime Kuma автоматически определит дату окончания сертификата.
- Мониторинг домашнего сервера. Если вы держите дома NAS или медиасервер, Uptime Kuma может проверять доступность его веб-интерфейса или порта SSH из интернета. В случае пропадания связи будет ясно, когда именно это произошло.
- Публичная статус-страница для клиентов. Можно включить экран со списком всех сервисов и их состоянием: в норме, проблемы, недоступен. Клиенты будут видеть, что ведётся обслуживание, а не думать, что вы просто бросили проект.
Частые ошибки при настройке
1. Не настроены уведомления. Самая распространённая ошибка: пользователь добавил монитор, но забыл привязать канал оповещений. Инциденты видны в панели, но на телефон никаких сигналов не приходит. Всегда сразу настраивайте уведомления и отправляйте тестовое сообщение.
2. Слишком короткий интервал проверок. Проверка каждые 10 секунд действительно позволяет быстрее узнать о проблеме, но создаёт лишнюю нагрузку на сервер, особенно если вы мониторите несколько десятков ресурсов. Рекомендуемый интервал — 60 секунд, а для личных сайтов можно и 5 минут.
3. Не настроен HTTPS. По умолчанию Uptime Kuma открывается по HTTP. Если вы планируете подключаться к панели из ненадёжных сетей, лучше настроить реверс-прокси на Nginx (промежуточный сервер, который принимает внешние HTTPS-запросы и передаёт их приложению по HTTP) и выпустить бесплатный SSL-сертификат Let's Encrypt. Это защитит трафик между вами и сервером от перехвата.
4. Игнорирование повторов (retries). Если проверка провалится один раз из-за короткого сетевого сбоя, вы получите ложную тревогу. Установите хотя бы 2–3 попытки, чтобы реальный инцидент отличался от случайного таймаута.
5. Данные не хранятся на диске. Если при запуске контейнера вы не указали том -v /opt/uptime-kuma:/app/data, вся история и настройки будут храниться внутри контейнера. При каждом пересоздании контейнера все данные пропадут. Всегда подключайте каталог для данных.
6. Забываете обновлять Uptime Kuma. Авторы регулярно выпускают новые версии с исправлениями и функциями. Проверить наличие обновлений можно в веб-панели, но обновление контейнера занимает пару минут: скачайте новый образ и пересоздайте контейнер с сохранением тома.
Вывод
Uptime Kuma — отличный выбор для тех, кто хочет контролировать доступность своих сайтов без ежемесячных платежей. Настройка на VPS занимает не более 15 минут: нужно установить Docker, запустить контейнер, создать администратора и добавить монитор. Дальше останется лишь настроить уведомления, чтобы узнавать о проблемах вовремя.
Что сделать прямо сейчас:
- Выберите VPS-тариф и создайте сервер на Ubuntu или Debian. Посмотрите доступные конфигурации на странице VPS-серверов Serverspace.
- Установите Docker и запустите контейнер Uptime Kuma по командам из этой статьи.
- Добавьте первый монитор для вашего сайта и привяжите уведомления в Telegram или почту.
Через пару недель вы заметите, что многие проблемы стали решаться ещё до того, как о них успели сообщить пользователи. А если захотите покопаться глубже — можете поднять второй экземпляр Uptime Kuma на другом сервере и сделать мониторинг самого мониторинга.
FAQ
1. Сколько стоит использование Uptime Kuma?
Сама программа бесплатна. Вы платите только за аренду VPS-сервера, на котором она запущена. Тарифы начинаются от 200–300 рублей в месяц в зависимости от провайдера.
2. Какие минимальные характеристики нужны для VPS?
Для проверки нескольких сайтов достаточно 1 vCPU, 1 ГБ RAM и 20 ГБ диска. Но с учётом Docker и возможного роста количества мониторов лучше брать от 1 ГБ RAM.
3. Можно ли мониторить сайты, которые находятся не на моём сервере?
Да. Uptime Kuma отправляет запросы из интернета, поэтому может проверять любые сайты, API и серверы, если они доступны по сети.
4. Нужно ли покупать домен для Uptime Kuma?
Нет, панель доступна по IP-адресу и порту. Однако для включения HTTPS и создания публичной статус-страницы с красивым адресом желательно иметь домен.
5. В чём отличие Uptime Kuma от платных сервисов мониторинга?
Основные отличия — цена и контроль над данными. Платные сервисы берут деньги за каждую проверку, но избавляют от необходимости обслуживать собственный сервер. Uptime Kuma предоставляет почти те же функции бесплатно, но требует технического ухода.
6. Что делать, если Uptime Kuma периодически не отправляет уведомления?
Проверьте настройки подключения к каналу уведомлений, например токен Telegram или параметры SMTP. Также посмотрите, не слишком ли часто приходят сообщения — некоторые мессенджеры ограничивают частоту отправки. В качестве отладки используйте тестовое уведомление из настроек.