Ваш сайт example.com работает на VPS, и о том, что он упал, вы узнаёте от клиента или случайно, заглянув на страницу. Хочется наоборот: чтобы сообщение о сбое приходило вам в Telegram раньше, чем кто-то успеет заметить. Для этого подойдёт Uptime Kuma, и ставить её мы будем на отдельный сервер, на адрес status.example.com.
Uptime Kuma это программа для мониторинга: она по расписанию проверяет сайты, порты и серверы и сообщает, когда что-то перестало отвечать. Внешние сервисы мониторинга делают то же самое, но бесплатно проверяют редко или ограничивают число сайтов. Своя Kuma проверяет столько адресов, сколько нужно, хоть раз в 20 секунд.
Проверено 18 октября 2026 года. На российском VPS с Ubuntu 24.04 образ
louislam/uptime-kuma:2(версия 2.5.6) скачался с Docker Hub за 52 секунды и занял 2,5 ГБ на диске. Запущенная Kuma без проверок занимала 108 МБ памяти. Первый вход, проверка сайта и форма уведомлений пройдены в браузере. С сервера в Санкт-Петербурге адрес api.telegram.org в тот же день открывался. Выпуск сертификата Caddy в этот раз не проверялся: та же схема работает в нашей статье об установке n8n.
Что подготовить до установки
- Отдельный VPS, не тот, на котором работает сайт. Kuma хватает 1 ядра и 1 ГБ памяти, свободного места на диске нужно от 5 ГБ. Самые дешёвые VPS в нашей базе стоят от 129 ₽ в месяц на 17 ноября 2026 года, подборка: VPS 1 ядро, 1 ГБ. Если взять сервер у другого хостера, Kuma заметит и сбой всего хостера, а не только вашего сервера.
- Установленный Docker с плагином Compose: инструкция.
- Поддомен, например
status.example.com, у которого A-запись указывает на IP сервера с Kuma. - Открытые порты 80 и 443:
sudo ufw allow 80,443/tcp. Порт 80 нужен Caddy для получения сертификата.
Шаг 1. Что положить в папку проекта
mkdir -p ~/uptime-kuma && cd ~/uptime-kuma
nano compose.yaml
Первая строка создаёт папку проекта и переходит в неё, вторая открывает редактор. В нём вставьте:
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
volumes:
- uptime_kuma_data:/app/data
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile
- caddy_data:/data
- caddy_config:/config
volumes:
uptime_kuma_data:
name: uptime_kuma_data
caddy_data:
caddy_config:
Что здесь важно:
louislam/uptime-kuma:2это официальный образ второй версии. Тег2при обновлении подтягивает свежие выпуски 2.x, но не перескочит на 3.x.uptime_kuma_data:/app/dataэто том, в котором лежат проверки, история и настройки. Без тома всё пропадёт при пересоздании контейнера.- У Kuma нет секции
ports, то есть наружу она не открыта, и добраться до неё можно только через Caddy по HTTPS. Так сделано не случайно: порты, которые публикует Docker, проходят мимо правил ufw.
Теперь создайте файл Caddyfile рядом с compose.yaml:
nano Caddyfile
status.example.com {
reverse_proxy uptime-kuma:3001
}
Эти строки говорят Caddy: запросы к status.example.com передавать контейнеру uptime-kuma на порт 3001. Kuma обновляет страницу в браузере через WebSocket, но Caddy передаёт такие соединения сам, так что дополнительных настроек не нужно.
А если на сервере уже работает nginx или другой веб-сервер, порт 80 занят и Caddy не запустится. Тогда уберите Caddy из файла и подключите Kuma к имеющемуся серверу: пример для nginx есть в разделе Reverse Proxy документации Kuma.
Шаг 2. Как запустить Kuma и войти
docker compose up -d
docker compose logs -f uptime-kuma
Первая команда скачивает образы и запускает контейнеры в фоне. Вторая показывает журнал Kuma, и выйти из него можно сочетанием Ctrl+C. Когда в журнале появится Waiting for user action, откройте в браузере https://status.example.com.
Kuma спросит, какую базу данных использовать: встроенную MariaDB, внешнюю MariaDB/MySQL или SQLite. Для одного сервера и десятков проверок выберите SQLite, потому что это один файл в томе и его проще копировать. Язык интерфейса можно сразу переключить на русский в списке над вопросом.
Следующий экран создаёт учётную запись: логин, пароль и повтор пароля, кнопка «Создать». Не откладывайте этот шаг: до него любой, кто откроет страницу, станет администратором.
Шаг 3. Как добавить проверку для example.com
Нажмите «Новый монитор». В форме заполните поля:
- «Тип монитора»:
HTTP(s), он стоит по умолчанию; - «Имя»: как проверка будет называться в списке и в уведомлениях;
- «URL-ссылка»: адрес сайта, например
https://example.com/; - «Интервал опроса»: по умолчанию 60 секунд, этого хватает;
- «Попыток»: поставьте 2. С нулём Kuma сообщит о сбое после первого же неудачного ответа, а одна потерянная проверка бывает и у живого сайта.
В блоке «Дополнительно» включите «Уведомление об истечении срока действия сертификата»: Kuma заранее напомнит, если сертификат HTTPS на сайте не продлился. Уведомление об окончании срока домена включено по умолчанию.
Нажмите «Сохранить». Через несколько секунд проверка станет зелёной, а в журнале событий появится строка Доступен 200 - OK. Теперь Kuma следит за сайтом, но пока молча.
Шаг 4. Как получать сообщения о сбоях
Без уведомлений Kuma только рисует график. Откройте меню в правом верхнем углу, «Настройки», раздел «Уведомления», кнопка «Настроить уведомление». Kuma поддерживает больше 90 способов, два самых простых:
- Telegram. Создайте бота через @BotFather и скопируйте его токен в поле «Токен бота». Затем напишите боту любое сообщение и укажите свой ID в поле «ID чата»: рядом с полем есть кнопка, которая подставит его сама.
- Email (SMTP). Поля «Имя хоста», «Порт», «Логин», «Пароль», «От кого» и «Кому». Подойдёт почтовый ящик на Яндексе или Mail.ru: для них нужен пароль приложения из настроек почты, обычный пароль не подойдёт.
Отметьте «По умолчанию включён» и «Применить ко всем существующим мониторам», нажмите «Тест», потом «Сохранить». Если тестовое сообщение пришло, Kuma будет присылать такие же при каждом сбое и восстановлении сайта. Вот теперь о падении example.com вы узнаете первым.
Как обновить Kuma
cd ~/uptime-kuma
docker compose pull
docker compose up -d
pull скачивает свежие образы, а up -d пересоздаёт контейнеры, у которых образ поменялся. Том с проверками и историей при этом не затрагивается.
Как сохранить копию настроек
docker compose stop uptime-kuma
docker run --rm -v uptime_kuma_data:/data -v "$PWD":/backup alpine tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start uptime-kuma
Первая команда останавливает Kuma, чтобы база не менялась во время копирования. Вторая упаковывает содержимое тома в архив в текущей папке, а третья запускает Kuma обратно. Архив скопируйте на другой компьютер: о том, как построить копирование в целом, написано в статье резервные копии VPS.
Что сделать до запуска и после
До запуска пройдите первую настройку сервера и оставьте открытыми только порты 22, 80 и 443 по статье о настройке файрвола UFW. Если Kuma сообщает, что сайт отвечает медленно, проверьте, хватает ли ему ресурсов: читайте, как понять, что VPS не хватает.
Когда всё настроено, следующий сбой example.com не станет для вас новостью: сообщение о нём придёт в Telegram раньше, чем клиент успеет написать.
