Beszel
Мониторинг на своем сервере, который показывает состояние машин и Docker-сервисов: ресурсы, алерты и сетевые проверки. Помогает сопоставить замедление сайта с нагрузкой на сервер и контейнеры, а также проверить доступность нужных сервисов с самой наблюдаемой машины.
Вердикт
- Администратору нескольких VPS, которому нужны готовые графики ресурсов и пороговые алерты.
- Владельцу Docker-сервисов: видеть загрузку хоста и каждого контейнера рядом с доступностью HTTP.
- Для проверки DNS и соединений именно с наблюдаемого сервера.
- Для расследования запросов через APM и трассировку.
- Для своих метрик на PromQL и общего поиска по логам.
- Как единственный независимый наблюдатель за сервером, на котором он сам работает.
Видеть состояние сервера и его сервисов
Сайт стал отвечать медленнее. В Beszel можно открыть тот же сервер, посмотреть загрузку CPU, память и контейнеры, затем сопоставить их с историей HTTP-проверки.
Готовые графики уже собраны: не нужно сначала проектировать дашборд. В таблице контейнеров видны потребление ресурсов, состояние проверки здоровья, образ и время обновления.
Агент выполняет сетевые пробы с наблюдаемой машины. Поэтому DNS-проверка отвечает на практический вопрос: разрешается ли имя у этого сервера, а TCP-проверка показывает доступность нужного порта.
Интерфейс переведен на русский. История метрик помогает увидеть, когда началась проблема, а пороговые алерты - узнать о превышении заданного значения.
Что изменилось с прошлого разбора
Предыдущая статья описывала 0.20.0. В релизе 0.21.0 от 2 октября сетку активных алертов заменили баннером: кнопка открывает боковую панель со сработавшими правилами.
В сетевых мониторах появились выбор видимых столбцов и сравнение целей. На одном узле мы выбрали два HTTP-адреса и получили две линии отклика и потерь.
HTTPS-монитор показывает оставшийся срок сертификата. У DNS-монитора можно указать свой DNS-сервер; пустое поле оставляет системный резолвер агента.
Вендор также исправил переподключение агентов и расчет ряда метрик. Это причина обновлять хаб вместе с агентами: интерфейс получает данные именно от их сборщиков.
Четыре опубликованных бюллетеня касаются более ранних версий: их исправления вошли в 0.20.0 или раньше. Переход на 0.21.0 не следует считать первым закрытием этих проблем; таблица ниже помогает проверить старую установку.
Чем отличается от платного мониторинга
Beszel не считает подключенные машины как платные лицензии. Вы оплачиваете свой сервер и обслуживаете установку; код распространяется по MIT, отдельную редакцию для показанных функций покупать не требуется.
| Продукт | За что платите | Что учитывать в РФ |
|---|---|---|
| Beszel | Свой сервер; лицензия MIT | История на сервере хаба, русский UI |
| Datadog Infrastructure Pro | От $15 за хост в месяц при годовой оплате | Условия поставки ограничивают получателей в России |
| Netdata Cloud Business | $4,50 за узел в месяц при годовой оплате | Метрики локальные, Cloud-метаданные хранятся в США |
Цены проверены 15 октября 2026 по прайсу Datadog и прайсу Netdata. У Datadog ограничение закреплено в MSA, пункт 10.2(b): доступность сайта не означает возможность купить подписку.
Подмена одного продукта другим зависит от задачи. Beszel дает готовый ресурсный мониторинг; цены более широких платформ не превращаются автоматически в экономию для вашей установки.
Если Prometheus с Grafana уже настроены, начинайте с конкретной нехватки: нужен ли отдельный простой экран для хостов и контейнеров. Переносить работающий мониторинг только из-за размеров образа незачем.
Как устроены хаб и агент
Хаб хранит пользователей, системы и историю в SQLite через PocketBase. Внешняя база не нужна. Каталог /opt/beszel/beszel_data содержит обе базы и служебные файлы.
Агент работает на каждой наблюдаемой машине и подключается к хабу по WebSocket. Для подключения нужны токен системы и публичный ключ хаба; их выдает диалог добавления системы.
В примере агент и хаб стоят рядом и используют общий Unix-сокет. Наружу хаб выходит через Caddy, а порт 8090 привязан к localhost. Агенту смонтирован Docker socket для статистики контейнеров.
Где выполняется проверка. HTTP-отклик в таблице сетевых мониторов измерен с агента. Это другой маршрут, чем открытие страницы в вашем браузере. Сравнивая числа, сначала определите точку наблюдения.
Какой сервер выбрать
Для начала берите CPU2-RAM4-DISK50: 2 vCPU и 4 ГБ RAM. На таком стенде работали хаб, агент и Caddy, одна наблюдаемая система и три сетевых монитора.
Численный минимум памяти вендор не задает. Здесь рекомендация следует из проверенной установки, а не из пересчета одного бинарника на сотни серверов.
Подготовьте Ubuntu 24.04, доступ по SSH с sudo и домен, направленный на IP сервера. Для HTTPS откройте входящие TCP 80 и 443; порт 8090 открывать в панели облака не требуется.
В команде ниже замените ваш-домен своим именем. Для VPS Fatmetal можно взять адрес вида IP-с-дефисами.fatmetal.net, который показан в панели сервера.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe от 585 ₽/мес
Развертывание на Fatmetal Cloud Server
Подключитесь по SSH и выполните sudo -i. Все команды ниже выполняются в одном root-сеансе. Адрес почты admin@example.com замените своим.
Установите Docker из официального репозитория
Дождитесь окончания apt: без Docker следующий шаг не запустится.
apt-get update && apt-get install -y ca-certificates curl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc chmod a+r /etc/apt/keyrings/docker.asc echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable" > /etc/apt/sources.list.d/docker.list apt-get update && apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin systemctl enable --now dockerЗадайте домен и доступ
Пароль генерируется до открытия хаба наружу; файлы с доступами читает только root.
umask 077 mkdir -p /opt/beszel && cd /opt/beszel DOMAIN=ваш-домен printf 'DOMAIN=%s\n' "$DOMAIN" > .env printf 'USER_EMAIL=admin@example.com\nUSER_PASSWORD=%s\nAPP_URL=https://%s\n' "$(openssl rand -hex 18)" "$DOMAIN" > .env.hub touch .env.agentСоздайте Compose-файл
Теги закреплены на проверенных версиях. Профиль monitor пока оставляет агент выключенным.
cat > compose.yml <<'YML' name: beszel services: beszel: image: henrygd/beszel:0.21.0 container_name: beszel restart: unless-stopped env_file: .env.hub ports: ["127.0.0.1:8090:8090"] volumes: ["./beszel_data:/beszel_data", "./beszel_socket:/beszel_socket"] healthcheck: test: ["CMD", "/beszel", "health", "--url", "http://localhost:8090"] interval: 5s timeout: 3s retries: 12 caddy: image: caddy:2.11.7 container_name: bz-caddy restart: unless-stopped network_mode: host depends_on: {beszel: {condition: service_healthy}} volumes: ["./Caddyfile:/etc/caddy/Caddyfile:ro", "./caddy_data:/data", "./caddy_config:/config"] beszel-agent: image: henrygd/beszel-agent:0.21.0 container_name: beszel-agent profiles: [monitor] restart: unless-stopped network_mode: host env_file: .env.agent environment: LISTEN: /beszel_socket/beszel.sock HUB_URL: https://${DOMAIN} volumes: ["./beszel_agent_data:/var/lib/beszel-agent", "./beszel_socket:/beszel_socket", "/var/run/docker.sock:/var/run/docker.sock:ro"] YMLЗапустите хаб за HTTPS
Caddy выпустит сертификат автоматически. При первом выпуске дождитесь готовности HTTPS.
printf '%s {\n reverse_proxy 127.0.0.1:8090\n}\n' "$DOMAIN" > Caddyfile docker compose pull && docker compose up -d --waitОткройте журнал, дождитесь строки
certificate obtained successfullyи нажмите Ctrl+C. Контейнеры при этом продолжают работать.docker compose logs -f caddyПроверьте готовый HTTPS-адрес:
curl --fail --show-error "https://$DOMAIN/api/health"Войдите и добавьте систему
Откройте HTTPS-адрес, войдите данными из файла ниже. Нажмите «Добавить систему»: имя monitoring-01, хост /beszel_socket/beszel.sock. Скопируйте из вкладки Docker публичный KEY и TOKEN этой системы.
cat .env.hubПодключите агент
Вставьте ключ и токен в запросы терминала. Токен при вводе не отображается.
read -r -p 'Публичный ключ хаба: ' AGENT_KEY read -r -s -p 'Токен системы: ' AGENT_TOKEN printf '%s=%s\n' KEY "$AGENT_KEY" TOKEN "$AGENT_TOKEN" > .env.agent docker compose --profile monitor up -d --wait
Откройте monitoring-01: статус должен стать «В Сети», появятся графики хоста и контейнеров. На чистой базе заданные USER_EMAIL/USER_PASSWORD создают обычного пользователя Beszel и отдельного суперпользователя PocketBase; это разные роли.
Настройте сетевые мониторы и алерт
На странице системы нажмите «Добавить Монитор». Выберите HTTP, укажите https://ваш-домен/api/health и интервал 5 секунд. После первого сбора появятся отклик, потери и срок сертификата.
Добавьте TCP для того же домена и порта 443. Для DNS задайте имя домена; поле «DNS-сервер» оставьте пустым для системного резолвера или впишите нужный адрес.
В меню «Вид» выберите полезные столбцы. Чтобы сравнить HTTP-цели, добавьте вторую, откройте строку первой и выберите вторую в «Сравнить с другими целями».
Для ресурсного алерта вернитесь в список систем и нажмите колокольчик. Включите «Использование памяти», задайте порог и длительность превышения. Для получения сообщений настройте канал в «Настройки - Уведомления».
Сколько ресурсов занимает работающий мониторинг
Стенд: CPU2-RAM4-DISK50, Ubuntu 24.04.4, Docker 29.9.1, Compose v5.6.0. Одна система, три монитора HTTP/TCP/DNS с интервалом 5 секунд.
| Память хаба / агента / Caddy | 11,4 / 5,8 / 12,0 MiB |
| Весь стек в простое | 29,2 MiB anon; файловые страницы отдельно |
| Пик при наблюдении | 34,8 MiB anon |
| Размеры образов по Docker | 47 / 15 / 93 МБ |
| Скачивание трех образов без локального кеша | 21 секунда |
| HTTPS после пересоздания контейнеров | 14 секунд с сохраненными данными и сертификатом |
| Отклик HTML через HTTPS | 34 мс |
Память процессов взята из cgroup anon, чтобы не выдавать файловый кеш за расход приложения. В прошлом разборе использовался docker stats, поэтому выводить из этих чисел процент ускорения или экономии нельзя.
За пять минут фонового сбора добавились шесть записей состояния хоста, шесть записей контейнеров и 18 записей сетевой статистики. Память колебалась и к концу снизилась: непрерывного роста в этом сценарии не было.
Для такого начала достаточно выбранного тарифа. При расширении парка смотрите фактическое потребление своего хаба, а не умножайте расход одного агента на число серверов.
Проверено на версии v0.21.0, 15 октября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. Команда запуска выполнена до окончания установки Docker. Именно это произошло при подготовке стенда.
Решение. Дождитесь завершения apt и проверьте обе команды; повторять скачивание образов до этого бессмысленно.
docker --version
docker compose versionПроверка. Сначала прочитайте журнал агента, затем проверьте HTTPS с той машины, на которой он установлен.
cd /opt/beszel
docker compose logs --tail=50 beszel-agent
curl --fail --show-error https://ваш-домен/api/healthРешение. Сверьте токен выбранной системы и публичный ключ хаба в .env.agent. При смене хаба переподключите агент с новой парой. При первом запуске Caddy дождитесь получения сертификата, как указано в установке. Для собственного центра сертификации укажите CA_CERT_FILE и смонтируйте файл CA; отключать проверку сертификата не нужно.
Хаб собран из scratch и не содержит shell. Для диагностики используйте команды его бинарника и Docker logs: попытка выполнить внутри контейнера sh не является проверкой работоспособности хаба.
Безопасность, обновление и резервная копия
Сохраните .env.hub и .env.agent с правами 600. Первый файл содержит пароль входа, второй - токен системы. Docker socket дает агенту доступ к Docker API; суффикс :ro не превращает этот API в доступ только для чтения.
Для почты откройте PocketBase по https://ваш-домен/_/ теми же первоначальными данными, затем Settings - Mail settings: задайте своего SMTP-провайдера и отправителя. На стенде доставка сброса пароля в собственный ящик подтверждена.
Перед обновлением остановите стек и сохраните весь каталог: здесь и база, и параметры подключения, и сертификат. Не копируйте работающие SQLite-файлы по одному.
cd /opt/beszel
docker compose --profile monitor stop
tar czf /root/beszel-backup.tgz -C /opt beszel
docker compose --profile monitor start
Для перехода с 0.20.0 в Compose-файле этой инструкции замените оба тега, затем проверьте версии. Резервная копия должна лежать отдельно от обновляемого каталога.
sed -i 's/:0.20.0/:0.21.0/g' /opt/beszel/compose.yml
cd /opt/beszel && docker compose --profile monitor pull
docker compose --profile monitor up -d --wait
docker exec beszel /beszel --version
docker exec beszel-agent /agent --version
Восстановление архива на этом же сервере выполняется с остановленным стеком. Архив содержит секреты: храните его в месте с ограниченным доступом.
cd /opt/beszel
docker compose --profile monitor stop
tar xzf /root/beszel-backup.tgz -C /opt
docker compose --profile monitor up -d --wait
После восстановления войдите в интерфейс, откройте систему и убедитесь, что время последнего обновления метрик продолжает меняться. Старый график сам по себе не доказывает, что агент подключился снова.
Уязвимости прошлых версий
В 0.21.0 из инструкции и в текущей карточке эти проблемы уже исправлены. Если установлен выпуск из таблицы, сделайте резервную копию и обновите хаб и агент командами выше.
| Бюллетень | Уровень | Затронуты / исправлено | Что это значит |
|---|---|---|---|
| GHSA-wqvf-7262-m7g8 | Средний | 0.9.0-0.19.0 / 0.20.0 | При открытой регистрации через OAuth/OIDC пользователь мог получить роль admin. |
| CVE-2026-27734 | Средний | До 0.18.3 включительно / 0.18.4 | Авторизованный пользователь мог читать посторонние GET-методы Docker API через агент. |
| GHSA-759g-ch5m-2gch | Средний | Раньше 0.19.0 / 0.19.0 | Зная ID чужой системы, пользователь мог подписаться на ее алерты. |
| CVE-2026-40077 | Низкий | До 0.18.6 включительно / 0.18.7 | Часть методов агента не проверяла доступ пользователя к системе. |
В GHSA-759g граница версий в бюллетене противоречива. Указанная здесь граница сверена по проверке прав в коде 0.19.0.
С чем использовать Beszel
Хаб, агенты и Caddy уже составляют рабочую установку. Дополнительные системы нужны под отдельную задачу, а не для запуска показанных экранов.
- Uptime Kuma на другом сервере - проверять доступность для внешнего наблюдателя, независимо от машины с приложением.
- SMTP-провайдер - доставлять письма сброса пароля; его реквизиты задаются в настройках PocketBase.
Начните с мониторинга одного сервиса: сопоставьте время ответа HTTP с CPU и памятью его контейнера. Такой сценарий быстрее показывает пользу продукта, чем пустая таблица из десятков добавленных систем.
Когда это НЕ ваш выбор
Нужно разбирать каждый медленный запрос
Для трассировки, прикладных метрик и запросов на PromQL выбирайте соответствующий стек APM и метрик. Beszel не определяет причину сбоя автоматически.
Нужен общий поиск по журналам
Просмотр логов отдельных контейнеров или systemd не заменяет центральное хранилище и поиск уровня Loki. Список обновлений пакетов работает с нативным Linux-агентом; Docker-агент его не собирает.
Проверка должна пережить отказ наблюдаемой машины
Агент на упавшем сервере сам ничего не проверит. Хаб и внешнюю проверку доступности размещайте отдельно от критичного сервиса.
Частые вопросы
Нужно ли ставить агент рядом с хабом?
В этой инструкции он наблюдает сам сервер хаба. При добавлении другой машины агент ставится на нее, а хаб остается общим.
Где взять пароль входа?
В /opt/beszel/.env.hub, поле USER_PASSWORD. Он сгенерирован командой до первого запуска; логин лежит в USER_EMAIL.
Зачем две учетные записи с одинаковым начальным паролем?
Обычный пользователь Beszel работает со своими системами. Суперпользователь PocketBase по адресу /_/ управляет базой и настройками почты. Созданный пользователь Beszel имеет роль user.
Как проверить, что история продолжает собираться?
Откройте систему и проверьте время обновления сетевого монитора через минуту. После перезапуска стенда оно изменилось, данные сохранились.
Нужен ли агенту docker.sock?
Он используется для статистики Docker. В примере путь /var/run/docker.sock смонтирован только в контейнер агента.
Можно использовать Beszel в компании?
Код версии 0.21.0 распространяется по MIT. Лицензия разрешает коммерческое использование; плата за хост в самом Beszel не вводится.
Итог
Beszel удобен, когда нужно видеть ресурсы сервера, контейнеры и результаты сетевых проверок в одном месте. В 0.21.0 стало проще разбирать сработавшие алерты и сравнивать HTTP-цели; русский интерфейс позволяет пройти эти действия без перевода меню.
Начать можно с одного сервера на CPU2-RAM4-DISK50. Сначала подключите агент и проверьте живое обновление графиков, затем добавляйте полезные пороги и пробы для своих сервисов.
Рекомендуемая конфигурация для установки:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe
Не хотите устанавливать вручную?
Запустите Beszel на этой конфигурации автоматически - от 585 ₽/мес.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.