---
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-ключи):

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

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

```bash
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`.
