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 від підбору паролів.
| Правило | Макс. спроб | Тривалість блокування |
|---|---|---|
| SSH | 5 невдалих входів | 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
Встановлене ПЗ
| Компонент | Версія |
|---|---|
| Ubuntu | 24.04 LTS |
| Uptime Kuma | 2.x |
| Node.js | 22.x LTS |
| PM2 | 6.x |
| Nginx | 1.24 |
| Fail2Ban | 1.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-консоль у клієнтській панелі |