Обновлено 16 октября 2026 г.
Наблюдаемость и аудит

Beszel

Мониторинг на своем сервере, который показывает состояние машин и Docker-сервисов: ресурсы, алерты и сетевые проверки. Помогает сопоставить замедление сайта с нагрузкой на сервер и контейнеры, а также проверить доступность нужных сервисов с самой наблюдаемой машины.

Проверено на версии v0.21.0, 15 октября 2026~12 минут чтенияFatmetal Team
Мониторинг серверов и DockerЛицензия: MITЗапущен: v0.21.0

Вердикт

Подходит
  • Администратору нескольких VPS, которому нужны готовые графики ресурсов и пороговые алерты.
  • Владельцу Docker-сервисов: видеть загрузку хоста и каждого контейнера рядом с доступностью HTTP.
  • Для проверки DNS и соединений именно с наблюдаемого сервера.
Не подходит
  • Для расследования запросов через APM и трассировку.
  • Для своих метрик на PromQL и общего поиска по логам.
  • Как единственный независимый наблюдатель за сервером, на котором он сам работает.
Рекомендуем: CPU2-RAM4-DISK50RAM в простое: 29,2 MiB (хаб, агент и Caddy)Сложность: низкая, Docker ComposeГлавный риск: перепутать токен системы и ключ хаба при подключении агентаПрод-готовность: для базового мониторинга с HTTPS и резервной копией
Что это

Видеть состояние сервера и его сервисов

Сайт стал отвечать медленнее. В Beszel можно открыть тот же сервер, посмотреть загрузку CPU, память и контейнеры, затем сопоставить их с историей HTTP-проверки.

Готовые графики уже собраны: не нужно сначала проектировать дашборд. В таблице контейнеров видны потребление ресурсов, состояние проверки здоровья, образ и время обновления.

Агент выполняет сетевые пробы с наблюдаемой машины. Поэтому DNS-проверка отвечает на практический вопрос: разрешается ли имя у этого сервера, а TCP-проверка показывает доступность нужного порта.

Интерфейс переведен на русский. История метрик помогает увидеть, когда началась проблема, а пороговые алерты - узнать о превышении заданного значения.

GoPocketBaseSQLiteDocker ComposeCaddy
Beszel 0.21.0: список систем на русском и баннер активного оповещения
Главный экран 0.21.0. Порог памяти 1% задан специально для демонстрации алерта; имена и адреса на кадрах заменены примерами.
Обновление

Что изменилось с прошлого разбора

Предыдущая статья описывала 0.20.0. В релизе 0.21.0 от 2 октября сетку активных алертов заменили баннером: кнопка открывает боковую панель со сработавшими правилами.

В сетевых мониторах появились выбор видимых столбцов и сравнение целей. На одном узле мы выбрали два HTTP-адреса и получили две линии отклика и потерь.

HTTPS-монитор показывает оставшийся срок сертификата. У DNS-монитора можно указать свой DNS-сервер; пустое поле оставляет системный резолвер агента.

Вендор также исправил переподключение агентов и расчет ряда метрик. Это причина обновлять хаб вместе с агентами: интерфейс получает данные именно от их сборщиков.

Четыре опубликованных бюллетеня касаются более ранних версий: их исправления вошли в 0.20.0 или раньше. Переход на 0.21.0 не следует считать первым закрытием этих проблем; таблица ниже помогает проверить старую установку.

Боковая панель активных оповещений Beszel 0.21.0
Правило памяти выше 1% за минуту действительно сработало. После съемки тестовое правило удалено.
Сравнение

Чем отличается от платного мониторинга

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 для статистики контейнеров.

i

Где выполняется проверка. HTTP-отклик в таблице сетевых мониторов измерен с агента. Это другой маршрут, чем открытие страницы в вашем браузере. Сравнивая числа, сначала определите точку наблюдения.

Графики CPU и памяти хоста и Docker в Beszel
Карточка реального узла: четыре графика ресурсов и сведения об ОС. Пустая часть шкалы соответствует времени до подключения агента.
Конфигурация

Какой сервер выбрать

Для начала берите 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 замените своим.

  1. Установите 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
  2. Задайте домен и доступ

    Пароль генерируется до открытия хаба наружу; файлы с доступами читает только 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
  3. Создайте 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
  4. Запустите хаб за 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"
  5. Войдите и добавьте систему

    Откройте HTTPS-адрес, войдите данными из файла ниже. Нажмите «Добавить систему»: имя monitoring-01, хост /beszel_socket/beszel.sock. Скопируйте из вкладки Docker публичный KEY и TOKEN этой системы.

    cat .env.hub
  6. Подключите агент

    Вставьте ключ и токен в запросы терминала. Токен при вводе не отображается.

    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-цели, добавьте вторую, откройте строку первой и выберите вторую в «Сравнить с другими целями».

HTTP, TCP и DNS мониторы Beszel с задержками и сроком сертификата
Четыре монитора одного узла. Четвертая цель добавлена для сравнения; ресурсный замер ниже сделан раньше, с тремя.

Для ресурсного алерта вернитесь в список систем и нажмите колокольчик. Включите «Использование памяти», задайте порог и длительность превышения. Для получения сообщений настройте канал в «Настройки - Уведомления».

Сравнение двух HTTP-целей одного агента в Beszel 0.21.0
Две цели на одном узле: / и /api/health. Сверху показаны срок сертификата и его издатель, ниже - отклик и потери.
Замеры

Сколько ресурсов занимает работающий мониторинг

Стенд: CPU2-RAM4-DISK50, Ubuntu 24.04.4, Docker 29.9.1, Compose v5.6.0. Одна система, три монитора HTTP/TCP/DNS с интервалом 5 секунд.

Память хаба / агента / Caddy11,4 / 5,8 / 12,0 MiB
Весь стек в простое29,2 MiB anon; файловые страницы отдельно
Пик при наблюдении34,8 MiB anon
Размеры образов по Docker47 / 15 / 93 МБ
Скачивание трех образов без локального кеша21 секунда
HTTPS после пересоздания контейнеров14 секунд с сохраненными данными и сертификатом
Отклик HTML через HTTPS34 мс

Память процессов взята из cgroup anon, чтобы не выдавать файловый кеш за расход приложения. В прошлом разборе использовался docker stats, поэтому выводить из этих чисел процент ускорения или экономии нельзя.

За пять минут фонового сбора добавились шесть записей состояния хоста, шесть записей контейнеров и 18 записей сетевой статистики. Память колебалась и к концу снизилась: непрерывного роста в этом сценарии не было.

Для такого начала достаточно выбранного тарифа. При расширении парка смотрите фактическое потребление своего хаба, а не умножайте расход одного агента на число серверов.

Таблица трех контейнеров Beszel, агента и Caddy
Потребление, здоровье и образы видны по контейнерам. Значение None означает отсутствие Docker healthcheck.

Проверено на версии v0.21.0, 15 октября 2026. На новых версиях результаты могут отличаться.

Диагностика

Где может сломаться

docker: command not found

Причина. Команда запуска выполнена до окончания установки 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-агент его не собирает.

Проверка должна пережить отказ наблюдаемой машины

Агент на упавшем сервере сам ничего не проверит. Хаб и внешнюю проверку доступности размещайте отдельно от критичного сервиса.

FAQ

Частые вопросы

Нужно ли ставить агент рядом с хабом?

В этой инструкции он наблюдает сам сервер хаба. При добавлении другой машины агент ставится на нее, а хаб остается общим.

Где взять пароль входа?

В /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 ₽/мес.

Запустить Beszel →
Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.