Uptime Kuma: моніторинг аптайму на вашому сервері
Моніторинг на власному сервері, який щохвилини перевіряє ваші сайти й сервіси та повідомляє вас тієї ж миті, коли якийсь із них перестає відповідати.
Про Uptime Kuma
Uptime Kuma — інструмент моніторингу з відкритим кодом, який започаткував розробник Louis Lam; зараз це один із проєктів для розгортання у себе з найбільшою кількістю зірок на GitHub. Він перевіряє, чи все відповідає: сайти через HTTP(S), ключові слова на сторінці, TCP-порти, ping, DNS-записи, бази даних тощо.
Коли перевірка не проходить, він надсилає сповіщення одним із десятків підтримуваних каналів, зокрема в Telegram, Discord, Slack, електронною поштою чи через вебхуки. Також він відстежує час відповіді, попереджає про закінчення строку дії TLS-сертифікатів і дає змогу створювати публічні сторінки статусу для ваших клієнтів.
Його розгортають у себе, бо він легкий, безкоштовний і має охайний інтерфейс, який налаштовується за кілька хвилин. Ключова деталь — запускати його на окремому сервері: моніторинг, що живе на одній машині з вашим сайтом, не зможе повідомити, коли ця машина впаде.
Для чого його використовують
Сповіщення, коли сайт падає
Перевіряйте свій сайт і API щохвилини й отримуйте повідомлення в Telegram чи на пошту, щойно вони перестануть відповідати.
Попередження про закінчення сертифіката
Дізнавайтеся за кілька днів до того, як спливе строк дії HTTPS-сертифіката, а не від клієнтів.
Публічна сторінка статусу
Показуйте клієнтам поточний стан своїх сервісів на сторінці, яку контролюєте ви.
Після замовлення
Під час першого запуску сервера встановлюється Uptime Kuma й відкривається порт 3001 у фаєрволі, тож моніторинг доступний за адресою http://адреса-сервера:3001/. Під час першого відвідування ви створюєте акаунт адміністратора, тож відкрийте адресу, щойно сервер буде готовий. Потім додайте перший монітор і підключіть канал сповіщень.
Де його запускати
Uptime Kuma перевіряє звідти, де сам працює. Монітор на тому самому сервері, що й сервіси, за якими він стежить, падає разом із ними й не може вас попередити, тож тримайте його на окремому сервері від того, що він моніторить.
Власний домен і HTTPS для Uptime Kuma
Одразу після встановлення Uptime Kuma відповідає на IP-адресі сервера через звичайний HTTP. Щоб дати йому ім’я на кшталт status.example.com із сертифікатом, створіть у своєму DNS A-запис для цього імені, що вказує на IPv4-адресу сервера, а потім поставте перед Uptime Kuma Caddy: він сам отримує безкоштовний сертифікат Let's Encrypt і продовжує його. Команди нижче — для Ubuntu 24.04, на якій працюють наші сервери застосунків.
У панелі відкрийте у фаєрволі сервера TCP-порти 80 і 443: вони потрібні Caddy, щоб отримати сертифікат Let's Encrypt і віддавати сайт.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyКоли перед Uptime Kuma стоїть домен, його сторінками статусу можна ділитися з клієнтами: створіть сторінку статусу, оберіть, які монітори вона показує, і дайте посилання https://status.example.com/status/your-page. Також домен можна прив’язати безпосередньо до сторінки статусу в її налаштуваннях.
Коли домен запрацює, прямий порт 3001 більше нікому не потрібен: у /opt/uptime-kuma/compose.yml змініть "3001:…" на "127.0.0.1:3001:…", виконайте docker compose up -d і приберіть порт 3001 із фаєрвола. Відтоді Uptime Kuma доступний лише через HTTPS.
Оновлення Uptime Kuma
Образи в /opt/uptime-kuma/compose.yml закріплено за точними версіями, тож звичайний docker compose pull завантажить ту саму версію ще раз. Щоб оновитися, змініть версію в рядку image: на потрібну (спершу прочитайте примітки до релізу), потім завантажте образи й перестворіть контейнери. Дані лежать у томах Docker і зберігаються.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dРезервне копіювання Uptime Kuma
У панелі можна ввімкнути щоденні резервні копії всього сервера (+20 % до ціни тарифу, зберігаються останні 7 копій) і відновити сервер із будь-якої з них. Та копію власних даних застосунку у файлі все одно варто мати: її можна перенести на інший сервер або відновити, не відкочуючи все інше.
Монітори, налаштування сповіщень та історія перевірок лежать у томі uptime-kuma_uptime_kuma (/app/data). Ненадовго зупиніть застосунок, щоб файл бази даних скопіювався в узгодженому стані:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startЯк це працює
- Оберіть Uptime Kuma на сторінці замовлення сервера й тариф із достатнім обсягом пам’яті.
- Застосунок встановлюється на сервер під час першого запуску, зазвичай за кілька хвилин.
- Відкрийте сервер у панелі: там будуть адреса й дані для входу.