📊 Мониторинг Beszel — быстрый старт (памятка)
⚠️ Важно: официальный сайт Beszel у пользователей из России часто открывается только через VPN. Поэтому здесь — короткая памятка на русском, чтобы всё было под рукой.
🔗 Официальный источник
Основной гайд: Getting Started на официальном сайте Beszel:
👉 https://www.beszel.dev/guide/getting-started
Эта статья сделана как краткий конспект по официальной инструкции.
🧩 Что разворачиваем
- Beszel Hub — веб-интерфейс управления мониторингом (панель).
- Beszel Agent — контейнер на каждом сервере, который хотим мониторить.
Идея простая: сначала поднимаем Hub, потом подключаем к нему нужные сервера через Agent.
1) 🚀 Поднимаем Beszel Hub (панель управления)
Что делаем
Разворачиваем основной контейнер Beszel Hub на сервере, где будет жить веб-панель.
Для чего
Чтобы получить единый интерфейс мониторинга: метрики, список серверов и управление подключениями.
Пример запуска через Docker Compose
services:
beszel-hub:
image: henrygd/beszel:latest
container_name: beszel-hub
restart: unless-stopped
ports:
- "8090:8090"
volumes:
- beszel_data:/beszel_data
volumes:
beszel_data:
Запуск:
docker compose up -d
После запуска открой веб-интерфейс Hub в браузере:
http://YOUR_SERVER_IP:8090
2) ➕ Добавляем новый сервер в мониторинг (ВАЖНО)
Что делаем в веб-панели Hub
- Нажимаем добавление нового сервера.
- Указываем:
- любое удобное название сервера,
- IP-адрес сервера.
- Нажимаем Copy Docker Compose.
Для чего
Hub сгенерирует готовый docker-compose для агента именно под этот сервер и токен подключения.
3) 🐳 Поднимаем Agent на сервере, который мониторим
Что делаем
- Подключаемся к целевому серверу.
- Вставляем docker-compose, который скопировали из Hub (Copy Docker Compose).
- Запускаем агент:
docker compose up -d
Для чего
Agent начинает отправлять метрики в ваш Hub.
4) ✅ Завершаем подключение в веб-панели
После старта Agent возвращаемся в веб-интерфейс Hub и просто нажимаем OK.
Готово — сервер появится в мониторинге.
🔍 Базовая проверка
- Hub-контейнер запущен:
docker ps | grep beszel-hub - Agent-контейнер запущен на целевом сервере:
docker ps | grep beszel - Сервер отображается в веб-интерфейсе Hub и обновляет метрики.
📝 Короткий итог
- Hub поднимается один раз.
- Каждый новый сервер добавляется через кнопку Copy Docker Compose в Hub.
- На новом сервере поднимается Agent.
- В Hub подтверждаем подключение кнопкой OK.
Если нужен полный и актуальный разбор, всегда сверяйся с официальным руководством Beszel:
👉 https://www.beszel.dev/guide/getting-started