Newer
Older
gnexus-book / 10-systems / services / hard-panel.md

owner: gmikcon status: active last_reviewed: 2026-09-10 review_interval: 90d confidence: high

source_of_truth: deployment-verified

hard-panel (GHard Monitor)

Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js).

  • Репозиторий: https://git.gnexus.space/root/hard-panel
  • Хост: VM service на hp-proliant-dl380-g6, адрес 192.168.1.176
  • SSH: root / пароль в gnexus-creds (секрет hard-panel (192.168.1.176)), также ubuntu с тем же паролем
  • ОС: Ubuntu 22.04.5 LTS, 4 GB RAM, 31 GB диск

Панель

  • Docker Compose: /opt/hard-panel/docker-compose.yml, контейнер ghard-panel
  • Порт: 8000 (HTTP, без TLS — доступ только из LAN)
  • Конфиг: /opt/hard-panel/.env (GHARD_ADMIN_TOKEN, GHARD_DATABASE_PATH=/data/hard-panel.db, GHARD_OFFLINE_MULTIPLIER=3)
  • Данные: docker volume panel-data (SQLite, WAL)
  • Health: http://192.168.1.176:8000/api/v1/health → {"status":"ok"}
  • UI: http://192.168.1.176:8000/ (без логина)
  • API: http://192.168.1.176:8000/docs (OpenAPI)
  • MCP: http://192.168.1.176:8000/mcp (streamable HTTP; инструменты panel_overview, server_details, server_history)
  • Логи: docker logs ghard-panel

Важно про GHARD_ADMIN_TOKEN

  • Веб-интерфейс не умеет подписывать запросы токеном (panel/frontend/src/api.js): если токен задан, UI получает 401 и показывает пустой список серверов.
  • В docker-compose.yml дефолт ${GHARD_ADMIN_TOKEN:-change-me} подставляет change-me даже при пустой переменной в .env. Локально исправлено на строгую форму ${GHARD_ADMIN_TOKEN-} (2026-09-10) — при git pull проверить, не вернулся ли старый синтаксис.
  • Текущее состояние: токен пустой (API и UI открыты, доступ только из LAN). Если панель когда-нибудь выйдет в интернет — задать токен и закрыть /mcp на reverse proxy.
  • Старый сгенерированный токен хранится в gnexus-creds (секрет hard-panel (192.168.1.176), поле admin_token) на случай, если токен снова включат.

Агент на самом хосте

  • Установлен через monitor/install.sh в /opt/hard-monitor (venv + psutil + requests)
  • systemd-юнит: hard-monitor.service, интервал 30 с
  • Сервер на панели: hard-panel-176 (id 1), ключ агента в gnexus-creds
  • Логи: journalctl -u hard-monitor -f

Развёртывание агентов на другие серверы

С хоста .176 (root, SSH-ключи):

cd /opt/hard-panel/monitor
./deploy.sh --panel http://192.168.1.176:8000 root@<host>

Или curl-ом на целевом хосте:

curl -fsSL https://git.gnexus.space/root/hard-panel/raw/branch/master/monitor/install.sh | \
    sudo bash -s -- http://192.168.1.176:8000 ghm_<ключ> 30

Ключ агента создаётся кнопкой «Добавить сервер» в UI или POST /api/v1/servers с Bearer-токеном.

История развёртывания

  • 2026-09-10: панель развёрнута (docker-compose build), агент установлен на сам хост, сервер hard-panel-176 online. Root-SSH на VM включён (PermitRootLogin yes, пароль задан).
  • 2026-09-10: UI показывал пустой список — причина: заданный GHARD_ADMIN_TOKEN, который UI не подписывает. Токен отключён, compose-дефолт исправлен на ${GHARD_ADMIN_TOKEN-}. Проверено: GET /api/v1/servers без токена отдаёт hard-panel-176 online.