☰
20.10.2026

Как настроить Uptime Kuma на VPS

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

Зачем нужен мониторинг

Мониторинг доступности решает простую, но важную задачу: он вовремя сообщает, что сайт, API или веб-приложение перестали отвечать. Для интернет-магазина даже десять минут простоя означают потерянные заказы, для корпоративного портала — сорванные рабочие процессы. Ручная проверка «в лоб» не подходит, ведь сбои часто случаются ночью или в выходные. Система мониторинга следит за состоянием ресурса круглосуточно и уведомляет вас первым делом, когда появляется проблема.

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

Основные понятия

Прежде чем переходить к настройке, уточним термины, которые будем использовать.

Весь процесс настройки 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

Разберём, что делает эта команда:

После запуска откройте в панели управления сервером порт 3001 (или разрешите его в файрволе командой sudo ufw allow 3001/tcp). Затем в браузере перейдите по адресу http://IP_вашего_сервера:3001. Откроется страница создания администратора: придумайте логин и пароль. Обязательно сохраните их в менеджере паролей — восстановить доступ без потери данных будет сложно.

Шаг 4. Добавление мониторов

После входа в панель вы увидите пустой интерфейс. Нажмите «Add New Monitor» (Добавить новый монитор), чтобы создать первую проверку. В настройках обратите внимание на основные поля:

Типов проверок в 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. Понадобится:

Сохраните настройки и отправьте тестовое сообщение. Если в указанный чат пришла проверка, значит всё работает.

Для каждого монитора можно выбрать конкретные уведомления: например, о сбое сайта отправлять в Telegram, а о проблемах с SSL — только на почту. Так вы не заспамите себя лишними сообщениями.

Плюсы и минусы Uptime Kuma

У любого инструмента есть сильные и слабые стороны. Uptime Kuma не исключение.

Преимущества:

Недостатки и ограничения:

Типовые сценарии использования

  1. Мониторинг личного блога. У вас небольшой сайт на WordPress. Создаёте монитор HTTP(s) для главной страницы, ставите интервал 5 минут и спокойно работаете. При сбое придёт уведомление в Telegram, и вы успеете среагировать до прихода посетителей.
  2. Контроль API для мобильного приложения. Разработчики часто используют Uptime Kuma для проверки бэкенда. Например, можно настроить проверку конкретного эндпоинта /health и получать сигнал, если ответ пришёл со статусом 500. Это удобно при командной разработке и проведении релизов.
  3. Слежение за SSL-сертификатом. Внезапно истекший сертификат — одна из самых частых причин «упавшего» сайта. Благодаря типу проверки SSL Certificate вы получите предупреждение за месяц до истечения срока. Укажите адрес проверяемого сайта, и Uptime Kuma автоматически определит дату окончания сертификата.
  4. Мониторинг домашнего сервера. Если вы держите дома NAS или медиасервер, Uptime Kuma может проверять доступность его веб-интерфейса или порта SSH из интернета. В случае пропадания связи будет ясно, когда именно это произошло.
  5. Публичная статус-страница для клиентов. Можно включить экран со списком всех сервисов и их состоянием: в норме, проблемы, недоступен. Клиенты будут видеть, что ведётся обслуживание, а не думать, что вы просто бросили проект.

Частые ошибки при настройке

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, запустить контейнер, создать администратора и добавить монитор. Дальше останется лишь настроить уведомления, чтобы узнавать о проблемах вовремя.

Что сделать прямо сейчас:

  1. Выберите VPS-тариф и создайте сервер на Ubuntu или Debian. Посмотрите доступные конфигурации на странице VPS-серверов Serverspace.
  2. Установите Docker и запустите контейнер Uptime Kuma по командам из этой статьи.
  3. Добавьте первый монитор для вашего сайта и привяжите уведомления в 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. Также посмотрите, не слишком ли часто приходят сообщения — некоторые мессенджеры ограничивают частоту отправки. В качестве отладки используйте тестовое уведомление из настроек.