---
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`) на случай, если токен снова включат.

## Агенты (fleet, 2026-09-10)

Агент hard-monitor установлен на все серверы home LAN. Все 18 серверов online (интервал 30 с):

| Сервер на панели | Хост | IP | Примечание |
| --- | --- | --- | --- |
| hard-panel-176 | VM service | 192.168.1.176 | сама панель |
| navi | VM navi | 192.168.1.168 | локальная машина Navi |
| gnbook | VM gnbook | 192.168.1.170 | |
| gnauth | VM gnauth | 192.168.1.167 | |
| gncreds | VM gncreds | 192.168.1.173 | |
| gnexus-home | VM gnexus-home | 192.168.1.151 | диск был 100%, почищен apt-кэш/журналы |
| nextcloud | VM nextcloud | 192.168.1.152 | |
| transmission | VM transmission | 192.168.1.154 | |
| files | VM files | 192.168.1.157 | |
| gitbucket | VM gitbucket | 192.168.1.156 | Ubuntu 18.04, py3.6 — venv на python3.8 + python3.8-dev |
| ovpn | VM ovpn | 192.168.1.150 | |
| vmk | VM vmk (tgbots) | 192.168.1.178 | |
| jellyfin | VM jellyfin | 192.168.1.153 | |
| mine | VM mine | 192.168.1.160 | |
| fuckjira | VM fuckjira | 192.168.1.175 | |
| mctl | VM mctl | 192.168.1.169 | |
| home | VM home | 192.168.1.159 | |
| internal-proxy | VM ovpn_reserv | 192.168.1.226 | |

Не охвачены (нет доступа или нецелевые):

- `192.168.1.129` и `192.168.1.131` — неидентифицированные хосты, SSH с известными паролями отклонён (Permission denied). Добавить агента, когда появятся креды.
- `alex` (192.168.105.195) — изолированная сеть 105.x, панель недостижима.
- pfSense (.1), klipper (.102), gbook (ноут, offline), IoT-сеть 192.168.2.0/24 — не серверы.

## Массовый деплой (как сделано)

С хоста .176 (root): `sshpass` + скрипт `/root/deploy-hard-monitor.sh` (и `/root/fix-remaining.sh` для отставших). Логика: DELETE старой записи на панели → POST новой (ключ ghm_ показывается один раз) → scp файлов агента из `/opt/hard-monitor-src` → `install.sh PANEL KEY 30` через sudo.

Грабли, проверенные на практике:

- `apt-get install python3-venv` без `apt-get update` падает 404 на старых зеркалах — сначала update.
- Ubuntu 18.04 (gitbucket): системный python3.6 не подходит (`from __future__ import annotations`, `list[str]`). Решение: `apt-get install python3.8 python3.8-venv python3.8-dev`, venv на python3.8, затем `pip install psutil requests`.
- Если `/tmp/hm` создан root'ом до scp — Permission denied; создавать от пользователя или чистить.
- Диск 100% (gnexus-home) ломает scp — `apt-get clean` + `journalctl --vacuum-size=50M`.

## Обновление агента

Повторный запуск `install.sh` с теми же PANEL_URL/SERVER_KEY перезаписывает файлы и рестартует юнит (конфиг `.env` не трогается). Файлы агента: `/opt/hard-monitor-src` на .176.

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

- 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`.
- 2026-09-10: массовый деплой агентов — 18/18 серверов online (16 VM DL380 + navi + панель). Скрипты: `/root/deploy-hard-monitor.sh`, `/root/fix-remaining.sh` на .176.
