О Uptime Kuma
Uptime Kuma - это self-hosted система мониторинга, которую разрабатывают Louis Lam и сообщество под лицензией MIT. Она с заданным интервалом опрашивает ваши сайты, API, TCP-порты, хосты (ping), DNS-записи и Docker-контейнеры, а при сбое отправляет уведомление в Telegram, Discord, Slack, на почту или через webhook. Интерфейс понятный, разобраться в нём можно без документации.
Инструмент рассчитан на разработчиков, агентства и небольшие команды, которые хотят узнавать о падении сервиса раньше клиентов и не платить за каждый монитор в SaaS-подписке. Если запустить Uptime Kuma на собственном VPS, данные мониторинга останутся под вашим контролем.
После выдачи на сервере установлены Docker, Uptime Kuma (образ louislam/uptime-kuma:2) и reverse proxy Caddy. Приложение слушает только 127.0.0.1:3001, а Caddy публикует его по HTTPS на порту 443 публичного IP-адреса сервера с самоподписанным сертификатом. Остаётся открыть URL и создать учётную запись администратора.
Что можно делать с Uptime Kuma
Множество типов мониторов
HTTP(S), поиск ключевого слова на странице, TCP, ping, DNS, Docker-контейнер и другие. Вы сами задаёте интервал проверки и число неудач до отправки оповещения.
Оповещения в привычных каналах
Telegram, Discord, Slack, e-mail по SMTP, webhook и множество других сервисов уведомлений доступны прямо в интерфейсе, плагины ставить не нужно.
Публичные страницы статуса
Вы публикуете страницу состояния сервисов для клиентов или команды, при желании на собственном домене.
Контроль TLS-сертификатов
Uptime Kuma считывает срок действия сертификатов у проверяемых HTTPS-сайтов и может предупредить вас до истечения.
Docker и Caddy уже установлены
Два контейнера с автоматическим перезапуском (
restart: always) описаны в файлеdocker-compose.yml, который можно редактировать и хранить в системе контроля версий.Данные в отдельном томе
Настройки и история мониторов хранятся в Docker-томе
kuma_data, что упрощает резервное копирование и обновления.
Начало работы с Uptime Kuma
От заказа до запуска за несколько минут.
- 1
Закажите VPS с Uptime Kuma
В форме заказа выберите Linux VPS (Париж или Франкфурт) с Debian 12, Debian 13 или Ubuntu 20.04, 22.04, 24.04. На вкладке «Applications» отметьте Uptime Kuma.
- 2
Дождитесь выдачи и откройте интерфейс
После выдачи сервера установка ещё несколько минут идёт в фоне (скачиваются Docker и образы). Затем откройте URL ниже. Браузер покажет предупреждение, потому что сертификат самоподписанный: добавьте исключение и продолжайте.
Bashhttps://SERVER_IP:443 # Проверить состояние контейнеров по SSH: ssh root@SERVER_IP cd /opt/uptime-kuma && docker compose ps - 3
Создайте администратора и первый монитор
При первом входе Uptime Kuma предложит создать учётную запись администратора. Затем добавьте монитор (например, HTTP(S) для вашего сайта) и настройте канал уведомлений, чтобы получать оповещения.
- 4
Подготовьте сервер к продакшену
Создайте DNS-запись A для YOUR_DOMAIN, указывающую на SERVER_IP, и замените адрес в Caddyfile на ваш домен: Caddy получит общепризнанный сертификат. Порты 80 и 443 должны оставаться открытыми, а порт 22 по возможности стоит ограничить вашими IP.
Bashcd /opt/uptime-kuma nano Caddyfile # YOUR_DOMAIN { # reverse_proxy 127.0.0.1:3001 # } docker compose restart caddy
Сценарии использования Uptime Kuma
Мониторинг сайтов и API
Один HTTP-монитор на каждый сайт или критичный endpoint и оповещение в Telegram или на почту, как только код ответа выходит за ожидаемый диапазон.
Страница статуса для клиентов
Агентство или SaaS-компания публикует состояние сервисов на отдельной странице, и на каждый вопрос не приходится отвечать вручную.
Контроль серверов и внутренних портов
Ping своих машин, TCP-проверка базы данных или SSH-сервиса, контроль Docker-контейнера: вся инфраструктура в одном окне.
Предупреждения об истечении сертификатов
Вы следите за сроком действия сертификатов своих доменов и получаете оповещение до того, как неудачное продление отключит сайт.
Частые вопросы о Uptime Kuma
Рецепт настраивает Caddy с директивой tls internal, которая создаёт самоподписанный сертификат для IP-адреса сервера. Шифрование работает, но браузер не может проверить издателя сертификата. Привяжите к серверу домен и измените Caddyfile, чтобы получить общепризнанный сертификат.
Подробнее о Uptime Kuma
Расположение файлов
Всё находится в /opt/uptime-kuma: скрипт установки install-uptime-kuma.sh, файл docker-compose.yml и Caddyfile. Caddy работает с network_mode: host и читает Caddyfile только на чтение.
Не запускайте скрипт установки повторно после правки Caddyfile: он перезапишет файл, подставив публичный IP-адрес, и настройки домена будут потеряны. Чтобы применить изменения, выполните docker compose restart caddy.
Переход с IP-адреса на домен
По умолчанию в Caddyfile указано https://IP_PUBLIQUE:443 и директива tls internal, поэтому сертификат самоподписанный. Если заменить эту строку доменным именем и убрать tls internal, Caddy сам запросит публичный сертификат и будет его продлевать. DNS к этому моменту уже должен указывать на сервер, иначе запрос завершится ошибкой.
Резервное копирование
Данные Uptime Kuma лежат в Docker-томе kuma_data. Надёжнее всего остановить контейнер на время копирования и затем заархивировать том.
Bashcd /opt/uptime-kuma docker compose stop uptime-kuma docker volume ls | grep kuma_data docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \ tar czf /backup/kuma-backup.tar.gz -C /data . docker compose start uptime-kuma
Точное имя тома зависит от каталога проекта, поэтому проверьте его командой docker volume ls. После этого скопируйте архив за пределы сервера. Снапшот VPS станет полезным дополнением.
Обновления
Образ использует тег 2, который следует за версиями 2.x. Чтобы получить последнюю версию, сделайте резервную копию и выполните:
Bashcd /opt/uptime-kuma docker compose pull docker compose up -d
Где разместить мониторинг
Монитор, работающий на том же сервере, который он проверяет, не предупредит вас, если этот сервер остановится целиком. Для важных сервисов ставьте Uptime Kuma на отдельный VPS, например на другой площадке (Париж или Франкфурт). Больше материалов вы найдёте в наших руководствах.

