Перейти к содержимому

Статья 86 из 141

Гайды

Uptime Kuma: мониторинг сайтов и серверов с уведомлениями в Telegram

Uptime Kuma каждые несколько секунд проверяет ваши сайты, боты, серверы и порты и сразу пишет в Telegram, если что-то перестало отвечать. Работает на младшем тарифе: нужно около 200–300 МБ памяти.

Совет: ставьте мониторинг на отдельный сервер, а не на тот, который проверяете. Если сервер упадёт, он не сможет сообщить об этом сам.

Нужен Docker.

Окно терминала
mkdir -p /opt/uptime-kuma && cd /opt/uptime-kuma
nano docker-compose.yml
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
ports:
- "127.0.0.1:3001:3001"
volumes:
- ./data:/app/data
Окно терминала
docker compose up -d

Создайте конфиг Nginx /etc/nginx/sites-available/uptime-kuma для домена status.example.com:

server {
listen 80;
server_name status.example.com;
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-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}

Интерфейс обновляется через WebSocket, поэтому заголовки Upgrade и Connection обязательны.

Окно терминала
ln -s /etc/nginx/sites-available/uptime-kuma /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d status.example.com

Подробнее: Nginx, Let’s Encrypt.

При первом входе Uptime Kuma 2 сначала спрашивает, какую базу данных использовать. Выберите язык и SQLite: этого хватает для сотен проверок. Встроенная MariaDB (Embedded MariaDB) и внешняя MariaDB/MySQL нужны для очень больших инсталляций.

Выбор базы данных при первом запуске Uptime Kuma

Подготовка базы занимает до минуты. Затем создайте аккаунт администратора: логин и пароль.

Создание администратора Uptime Kuma

Тип Что проверяет Пример
HTTP(s) сайт отвечает кодом 200 https://example.com
HTTP(s) — Keyword на странице есть нужный текст сайт не отдаёт страницу ошибки
TCP Port порт открыт SSH 22, Minecraft 25565, панель
Ping сервер отвечает на ICMP IP сервера
DNS домен указывает на правильный IP A-запись example.com
Push ваш скрипт сам сообщает «я жив» cron-задача бэкапа

Для HTTPS-проверок Uptime Kuma также предупреждает, когда сертификат скоро истечёт.

Новая проверка добавляется кнопкой Новый монитор: выберите тип, задайте название и адрес. Через минуту на странице монитора появятся статус, время ответа и срок действия сертификата:

Монитор сайта в Uptime Kuma: статус, отклик, сертификат

Push-монитор ждёт сигнала от вашего скрипта. Если сигнала нет в течение интервала, приходит уведомление. Удобно для бэкапов: добавьте в конец cron-задачи запрос на адрес, который показывает Uptime Kuma:

Окно терминала
/root/backup.sh && curl -fsS "https://status.example.com/api/push/КЛЮЧ?status=up&msg=OK" > /dev/null

Если бэкап упадёт, запроса не будет, и вы узнаете об этом.

  1. Создайте бота через @BotFather и получите токен.
  2. Напишите своему боту любое сообщение.
  3. В Uptime Kuma откройте Settings → Notifications → Setup Notification, выберите Telegram.
  4. Вставьте токен и нажмите Auto Get рядом с Chat ID.
  5. Нажмите Test: в Telegram должно прийти тестовое сообщение.
  6. Включите Default enabled, чтобы уведомление подключалось ко всем новым проверкам.

В разделе Status Pages можно сделать публичную страницу для клиентов: какие сервисы работают и сколько времени они были доступны. Её можно открыть на отдельном поддомене.

Окно терминала
cd /opt/uptime-kuma
docker compose pull && docker compose up -d

Все настройки и история лежат в /opt/uptime-kuma/data. Перед обновлением остановите контейнер и скопируйте каталог:

Окно терминала
docker compose stop
tar -czf /root/uptime-kuma-$(date +%F).tar.gz data
docker compose start
Симптом Причина
Bind for 127.0.0.1:3001 failed: port is already allocated порт 3001 занят другим сервисом (например, панелью Remnawave). Замените в ports левую часть: "127.0.0.1:3002:3001" и поправьте порт в Nginx
Интерфейс не обновляется, постоянно «переподключение» в Nginx нет заголовков WebSocket
Ложные срабатывания по HTTP слишком маленький тайм-аут или интервал, увеличьте Retries
Проверка порта на localhost не работает внутри контейнера localhost — это сам контейнер, указывайте IP сервера
Уведомления не приходят не написали боту первое сообщение или неверный Chat ID