Uptime Kuma

Обзор

Uptime Kuma — панель мониторинга для домашних серверов, небольших проектов и внутренней инфраструктуры. Она умеет проверять HTTP(S), TCP-порты, DNS, ping, сертификаты и другие цели, а затем отправлять уведомления через множество провайдеров.

Для небольшого инстанса не нужна отдельная база данных: данные сохраняются в локальном Docker volume. Есть русский интерфейс, публичные status pages и встроенный healthcheck контейнера.

Рецепт намеренно не подключает Docker socket. Он не нужен для обычного мониторинга сайтов и портов, а прямой доступ к socket существенно расширяет полномочия контейнера.

Оценка безопасности

Рецепт запускает контейнер без privileged, host network и Docker socket, добавляет no-new-privileges и публикует порт только на 127.0.0.1. Публичный доступ рекомендуется организовывать через HTTPS reverse proxy. Основной известный риск возникает только при отдельном подключении Docker API для мониторинга контейнеров: такой доступ следует выдавать через ограниченный socket proxy, а не прямым монтированием Docker socket.

Пошаговая инструкция

1. Проверьте сервер Ubuntu или Debian

Минимум: 1 CPU, 512 МБ RAM и 2 ГБ на локальном диске. Рекомендуется 1 ГБ RAM. Нужны Ubuntu 22.04+ или Debian 12+ с Docker Engine и Docker Compose v2.24+. Отдельная база данных не требуется. Не размещайте данные на NFS: upstream рекомендует локальную файловую систему или Docker volume.

docker --version
docker compose version

2. Подготовьте файлы и переменные

Поместите compose.yaml, .env.example, backup.sh, restore.sh и каталог proxy в отдельный каталог:

mkdir -p ~/services/uptime-kuma
cd ~/services/uptime-kuma
cp .env.example .env
chmod 600 .env

В .env заданы закреплённая версия UPTIME_KUMA_VERSION, локальный порт UPTIME_KUMA_PORT, имя volume UPTIME_KUMA_DATA_VOLUME и часовой пояс TZ.

3. Запустите контейнер на VPS

docker compose pull
docker compose up -d
docker compose ps

Образ содержит healthcheck. При первом запуске контейнер может несколько минут иметь статус starting. Порт по умолчанию доступен только на 127.0.0.1.

4. Первоначальная настройка через SSH

ssh -L 3001:127.0.0.1:3001 user@server.example

Откройте http://localhost:3001, создайте администратора и сохраните пароль в менеджере паролей.

Локальная сеть

Без reverse proxy безопаснее оставить localhost bind и использовать SSH-туннель. Если панель должна быть доступна всей доверенной LAN, замените 127.0.0.1 в compose.yaml на конкретный LAN-адрес сервера, например 192.168.1.10. Не используйте 0.0.0.0 и закройте порт 3001 на внешнем интерфейсе firewall.

Домен и HTTPS

Для reverse proxy, установленного непосредственно на host, готовые примеры находятся в proxy/Caddyfile, proxy/nginx.conf и proxy/traefik.yaml. Замените status.example.com своим доменом. Caddy получает сертификат автоматически; для Nginx пример предполагает сертификат Certbot; Traefik использует resolver letsencrypt. После публикации включите в Uptime Kuma параметр Trust Proxy. Все примеры передают WebSocket. Для Traefik в контейнере замените 127.0.0.1 на доступный контейнеру адрес host gateway.

Резервное копирование

Все данные находятся в volume uptime-kuma-data. Запустите ./backup.sh:

chmod +x backup.sh restore.sh
./backup.sh

Скрипт остановит контейнер, создаст архив в ./backups и снова запустит его. Храните копию архива вне сервера.

Восстановление

Восстановление полностью заменяет содержимое volume выбранным архивом:

./restore.sh ./backups/uptime-kuma-YYYYMMDDTHHMMSSZ.tar.gz
docker compose ps

Перед восстановлением скрипт создаёт страховочную копию текущих данных.

Обновление

Создайте backup, прочитайте release notes, измените UPTIME_KUMA_VERSION в .env, затем выполните:

docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 uptime-kuma

Откат

Верните прежнюю UPTIME_KUMA_VERSION в .env и запустите docker compose pull и docker compose up -d. Если новая версия успела мигрировать базу, сначала верните старый образ, затем восстановите созданный перед обновлением архив через restore.sh. Между major-версиями сверяйтесь с release notes upstream.

Полное удаление

Сохранить данные: docker compose down. Удалить контейнер и все данные безвозвратно:

docker compose down
docker volume rm uptime-kuma-data
rm -rf ~/services/uptime-kuma

Источники: официальная установка и инструкция по обновлению.

Диагностика

Контейнер не становится healthy

Посмотрите состояние и последние сообщения:

docker compose ps
docker compose logs --tail=200 uptime-kuma

На первом старте дождитесь завершения подготовки данных. Также проверьте, что на диске достаточно места и volume доступен для записи.

Страница открывается, но интерфейс теряет соединение

Uptime Kuma использует WebSocket. Проверьте конфигурацию reverse proxy и передачу заголовков Upgrade и Connection. Caddy обрабатывает WebSocket автоматически.

Порт 3001 занят

Измените UPTIME_KUMA_PORT в .env, например на 3101, и пересоздайте контейнер:

docker compose up -d

Если используется reverse proxy на хосте, обновите также его upstream-порт.

После обновления появилась пустая установка

Убедитесь, что используется тот же Docker volume:

docker volume inspect uptime-kuma-data
docker compose config

Не создавайте нового администратора и не удаляйте старый volume, пока не проверите путь к данным и имеющийся backup.