Table of Contents

Uptime Kuma — посібник для початку роботи

Uptime Kuma — self-hosted інструмент моніторингу, який дає змогу відстежувати доступність сайтів, API, DNS та інших сервісів через зручну панель із миттєвими сповіщеннями. Сервер постачається з встановленими Uptime Kuma, Nginx і PM2 — просто відкрийте вебінтерфейс і створіть обліковий запис адміністратора.


Крок 1 — перевірте, що Uptime Kuma працює

IP-адресу сервера й пароль root показано на сторінці Server Details у клієнтській панелі. Відкрийте браузер і перейдіть за адресою:

http://your.server.ip

Під час першого відкриття Uptime Kuma покаже форму реєстрації. Оберіть імʼя користувача і пароль, потім натисніть Create.

Важливо: Обліковий запис адміністратора створює перша людина, яка відкриє вебінтерфейс. Виконайте цей крок одразу після розгортання сервера.

Якщо ви розмістили сервер за маршрутизатором VyOS у приватній мережі, налаштуйте переадресацію портів (80 і 443), щоб відкривати Uptime Kuma з інтернету, або підключайтеся через VPN за приватною IP сервера.


Крок 2 — додайте перший монітор

Після входу натисніть Add New Monitor на панелі:

  • Monitor Type — HTTP(s), TCP, Ping, DNS та інші
  • Friendly Name — зрозуміла назва монітора
  • URL / Hostname — обʼєкт для моніторингу
  • Heartbeat Interval — як часто перевіряти (за замовчуванням 60 секунд)

Натисніть Save — і моніторинг почнеться одразу. Сповіщення (email, Telegram, Slack, Discord та багато інших) додаються в Settings > Notifications.


Крок 3 — налаштування домену та SSL (необовʼязково)

Щоб відкривати Uptime Kuma через домен із HTTPS, створіть DNS A-запис, що вказує домен на IP сервера. Потім підключіться через SSH і виконайте:

ssh root@your.server.ip
sed -i 's/server_name _;/server_name your-domain.com;/' /etc/nginx/sites-available/uptime-kuma
nginx -t && systemctl reload nginx
apt install -y certbot python3-certbot-nginx
certbot --nginx -d your-domain.com

Certbot налаштує SSL і автоматичне поновлення. Панель буде доступна за адресою https://your-domain.com.


Після встановлення

Fail2Ban — захист від підбору паролів

Сервер постачається з Fail2Ban , попередньо налаштованим для захисту SSH від підбору паролів.

Правило Макс. спроб Тривалість блокування
SSH5 невдалих входів10 хвилин

Корисні команди:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Якщо ви випадково заблокували себе, підключіться через VNC-консоль у клієнтській панелі й розблокуйте свою IP.

Керування сервісами

Uptime Kuma працює під PM2, який тримає його запущеним і автоматично перезапускає після збоїв чи перезавантажень.

# Check status
pm2 list

# View logs
pm2 logs uptime-kuma

# Restart
pm2 restart uptime-kuma

# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx

Резервні копії

Усі дані (монітори, сповіщення, історія статусів) зберігаються в SQLite. Експортувати й імпортувати їх можна у вебінтерфейсі (Settings > Backup) або зробити резервну копію через SSH:

cp -r /opt/uptime-kuma/data /root/uptime-kuma-backup-$(date +%F)

Оновлення

# Update Uptime Kuma
cd /opt/uptime-kuma
pm2 stop uptime-kuma
git fetch --all
git checkout $(git describe --tags --abbrev=0 origin/master)
npm install --production
npm run download-dist
pm2 restart uptime-kuma
pm2 save

# Update OS packages
apt update && apt upgrade -y

Встановлене ПЗ

Компонент Версія
Ubuntu24.04 LTS
Uptime Kuma2.x
Node.js22.x LTS
PM26.x
Nginx1.24
Fail2Ban1.0.2

Усунення проблем

Проблема Рішення
Вебінтерфейс не завантажується Перевірте статус: pm2 list. За потреби перезапустіть: pm2 restart uptime-kuma
502 Bad Gateway Можливо, Uptime Kuma не працює на порту 3001. Перевірте логи: pm2 logs uptime-kuma
Сповіщення не надсилаються Перейдіть у Settings > Notifications і скористайтеся кнопкою Test , щоб перевірити канал сповіщень
Високе використання памʼяті Збільште інтервал перевірок або очистьте стару історію статусів у Settings > General
Забули пароль адміністратора Підключіться через SSH і скиньте: cd /opt/uptime-kuma && npm run reset-password
Заблоковано Fail2Ban Розблокуйте свою IP через VNC-консоль у клієнтській панелі
Забули пароль root Скиньте його через VNC-консоль у клієнтській панелі