owner: gmikcon status: active last_reviewed: 2026-10-05 review_interval: 90d confidence: high
Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через os.statvfs). С версии 2026-10-04 (b6080d0, v1.30.0) — gnexus-auth (OAuth PKCE), health-чекер сервисов, журнал событий, интеграция с Gnexus Synapse, i18n (en/uk/ru), MCP-промпт agent_guide. С 40a8810 — персональные MCP-ключи. С 2026-10-05 панель закрыта за gnexus-auth (OAuth PKCE) и опубликована публично как https://hpanel.gnexus.space (nginx на .226, /mcp закрыт 403 на прокси).
https://git.gnexus.space/root/hard-panel (ветка master)service на hp-proliant-dl380-g6, адрес 192.168.1.176root / пароль в gnexus-creds (секрет hard-panel (192.168.1.176)), также ubuntu с тем же паролем/opt/hard-panel/docker-compose.yml, контейнер ghard-panel8000 (HTTP, без TLS — доступ только из LAN)/opt/hard-panel/.env (GHARD_ADMIN_TOKEN, GHARD_DATABASE_PATH=/data/hard-panel.db, GHARD_OFFLINE_MULTIPLIER=3, GHARDAUTH* — OAuth gnexus-auth)panel-data (SQLite, WAL)http://192.168.1.176:8000/api/v1/health → {"status":"ok"} (остаётся открытым без сессии)https://hpanel.gnexus.space/ (публично через nginx .226 + TLS; вход через gnexus-auth OAuth PKCE) / http://192.168.1.176:8000/ (LAN)http://192.168.1.176:8000/docs (OpenAPI)http://192.168.1.176:8000/mcp (streamable HTTP; тулы panel_overview, server_details, server_history, services_overview, service_incidents, events_recent; промпт agent_guide — инструкции агенту); снаружи закрыт 403 на прокси .226/mcp-keys — выпуск и ревок персональных токенов mcp_* (plaintext показывается один раз, в БД sha256-хэш + хвост-хинт)docker logs ghard-panelGET /auth/login (302 на auth.gnexus.space, PKCE S256, scopes openid email profile roles permissions), GET /auth/callback, POST /auth/logout, POST /webhooks/gnexus-auth (HMAC-подпись по GHARD_AUTH_WEBHOOK_SECRET; события user.blocked/deleted/archived + апдейты профиля → блокировка доступа и синк system_role), GET/PATCH /api/v1/me.gnx_3SstXPcFpvuBT9wMuVpsjXvQZZ1b6d8C, redirect https://hpanel.gnexus.space/auth/callback. Креды (client_secret, webhook_secret) — в gnexus-creds, секрет hard-panel gnexus-auth OAuth client (id 9aac8f69-ea1d-4526-a820-03e9f8687077)..env на .176: GHARD_AUTH_BASE_URL=https://auth.gnexus.space, GHARD_AUTH_CLIENT_ID, GHARD_AUTH_CLIENT_SECRET, GHARD_AUTH_REDIRECT_URI, GHARD_AUTH_WEBHOOK_SECRET, GHARD_AUTH_ALLOWLIST=goldmikki@gmail.com. Формат allowlist (проверено по allowlisted() в app/auth.py): пусто = любой залогиненный, иначе comma-separated e-mail или user_id (lowercase). Бэкап до правки: .env.bak-preauth-20261004.window.location.href="/auth/login?return_to=..." — фронт сам отправляет на логин./auth/login → 302 на https://auth.gnexus.space/oauth/authorize?...client_id=gnx_3Sst...&redirect_uri=https%3A%2F%2Fhpanel.gnexus.space%2Fauth%2Fcallback&code_challenge_method=S256 (локально и через публичный домен).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 проверить, не вернулся ли старый синтаксис (проверено 2026-10-04 дважды, форма сохранена).https://hpanel.gnexus.space, nginx .226) и закрыта за gnexus-auth (OAuth PKCE, allowlist владельца); /mcp закрыт 403 на прокси; API без сессии → 401.hard-panel (192.168.1.176), поле admin_token) на случай, если токен снова включат.40a8810 токен работает как супер-токен для /mcp (гард require_mcp): персональный Bearer mcp_* ИЛИ статический GHARD_ADMIN_TOKEN ИЛИ браузерная cookie-сессия gnexus-auth.edb6cff..b6080d0 (19 коммитов, 44 файла +3897/−251), версия MCP serverInfo 1.30.0.f52c853), gnexus-ui-kit 1.0 + тема Verdant + новый логотип (9625022, cd5b630), health-чекер сервисов — раздел «Сервисы», страницы сервисов с графиком и журналом недоступности (c6e8698, 19812b4, 5eef1bd), парсер самосвидетельства health-ответов по handbook spec §5 (fe202ff), журнал событий (fe6b21e), интеграция с Gnexus Synapse — этап 4 (fe6b21e), MCP: промпт agent_guide + тулы сервисов и журнала (fc0de93), i18n en/uk/ru + раздел Settings (b1a82e2), заметка сервера 184px + resize (af2cd8f), фиксы графиков/навигации/no-store (dfc511f, 50a9262, 9953bae, 84dfcfc).GHARD_AUTH_* (BASE_URL, CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, WEBHOOK_SECRET, ALLOWLIST), GHARD_SHARE_INTERVAL, GHARD_HEALTH_INTERVAL/TIMEOUT, GHARD_SYNAPSE_URL/API_KEY/DEFAULT_SOURCE/TIMEOUT.docker-compose.yml разрешён вручную: апстримный env-блок + локальные правки (строгая форма токена, 4 NAS-тома :slave). docker compose config валиден./data — hard-panel.db.bak-preupdate-20261004-2127 (файловая копия) и hard-panel.db.bak-sqlite-20261004-2127 (консистентный sqlite3 backup API, 1.6 GB).oauth_states, sessions, users, services, service_samples, events на месте)./api/v1/health ok, флот 19/19 online, агенты инжестят 200 OK, MCP initialize OK (GHard Monitor 1.30.0, 6 тулов + промпт agent_guide), /mcp без auth 406, SPA 200 с i18n-строками, synapse reporter корректно disabled (GHARD_SYNAPSE_API_KEY не задан)./auth/login → 500 ConfigurationException: Invalid gnexus-auth base URL — GHARD_AUTH_BASE_URL не был задан.b6080d0..40a8810 (4 коммита, 16 файлов +834/−19): 14007e0 feat: персональные MCP-ключи (канон handbook mcp.md); ca26b18 feat: страница «MCP-ключи» — выдача и ревок персональных токенов; 8b91999 docs: README — матрица доступа, API, ревок, блокировка; 40a8810 fix: кнопка «Выдать ключ» выровнена с полем ввода._try_alter добавил users.system_role (снейпшот роли gnexus-auth) и users.blocked (вебхук user.blocked/deleted/archived); CREATE TABLE IF NOT EXISTS mcp_tokens (user_id, name, user_email, system_role, token_hash UNIQUE, token_hint, created_at, last_used_at, revoked_at) — применены, схема проверена PRAGMA./mcp заменён на require_mcp: персональный Bearer mcp_* (выпуск на /mcp-keys), статический GHARD_ADMIN_TOKEN (супер-токен), браузерная cookie-сессия gnexus-auth..env.example без изменений./data/hard-panel.db.bak-sqlite-20261004-2155-premcp (1.6 GB, sqlite3 backup API, включает WAL)./api/v1/health ok, флот 19/19 online (транзиентный offline после рестарта восстановился за ~90с), агенты инжестят 200 OK, MCP initialize OK, /mcp-keys 200, synapse reporter disabled как раньше.Агент hard-monitor установлен на все серверы home LAN. Все 19 серверов 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 | |
| gnsynapse | VM gnsynapse | 192.168.1.172 | добавлен 2026-10-04, панель id 46 |
| 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, панель недостижима.Панель умеет мониторить сетевые диски: пробер на хосте панели делает os.statvfs по зарегистрированным путям и пишет историю (таблица share_samples). Шара считается offline, если нет замера дольше max(share_interval*3, 180) секунд.
Текущие шары (добавлены 2026-09-11, все online):
| Имя на панели | NFS-экспорт | Точка монтирования на .176 | Заполнено |
|---|---|---|---|
| secraid5-jellyfin-storage | 192.168.1.130:/mnt/secraid5/jellyfin_storage | /mnt/nas/secraid5-jf | ~89% |
| secraid5-jellyfin-cache | 192.168.1.130:/mnt/secraid5/jellyfin_cache | /mnt/nas/secraid5-cache | ~0.1% |
| firstraid5 | 192.168.1.130:/mnt/firstraid5 | /mnt/nas/firstraid5 | ~90% |
| NetTera8 | 192.168.1.131:/mnt/NetTera8 | /mnt/nas/nettera8 | ~93% |
Монтирование на .176: nfs-common, fstab-записи с _netdev,nofail,vers=3 (бэкап /root/fstab.backup). В контейнер шары проброшены bind-mount с propagation :slave в docker-compose.yml — хостовые NFS-монты автоматически видны внутри контейнера.
Смонтировать на хосте .176 (root):
apt-get install -y nfs-common mkdir -p /mnt/nas/<имя> echo "192.168.1.XXX:/экспорт /mnt/nas/<имя> nfs defaults,_netdev,nofail,vers=3 0 0" >> /etc/fstab mount -a && df -h /mnt/nas/<имя> # проверить
Пробросить в контейнер: в /opt/hard-panel/docker-compose.yml в секцию volumes: сервиса panel добавить строку:
- /mnt/nas/<имя>:/mnt/nas/<имя>:slave
и пересоздать контейнер (порядок важен — обычный up -d --build падает с KeyError 'ContainerConfig' на старом docker-compose 1.29):
cd /opt/hard-panel && docker-compose down && docker-compose up -d --build
Проверка: curl http://localhost:8000/api/v1/health и curl -s http://localhost:8000/api/v1/servers | grep -c online (должно быть 19).
Зарегистрировать шару в панели:
curl -s -X POST http://192.168.1.176:8000/api/v1/shares \
-H "Content-Type: application/json" \
-d '{"name": "<имя>", "path": "/mnt/nas/<имя>"}'
(если включён GHARD_ADMIN_TOKEN — добавить заголовок Authorization: Bearer <токен>; UI-путь: кнопка Add share в разделе Storage).
Проверить замер: подождать ~1 минуту (интервал пробера), затем:
curl -s http://192.168.1.176:8000/api/v1/shares | python3 -m json.tool
Статус должен стать online, появятся total/used. Если offline — проверить, что шара смонтирована на хосте и видна в контейнере: docker exec ghard-panel stat -f /mnt/nas/<имя>.
С хоста .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.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; создавать от пользователя или чистить.apt-get clean + journalctl --vacuum-size=50M.python3.10-venv — apt-get update && apt-get install -y python3.10-venv перед install.sh, иначе venv не создаётся.Повторный запуск install.sh с теми же PANEL_URL/SERVER_KEY перезаписывает файлы и рестартует юнит (конфиг .env не трогается). Файлы агента: /opt/hard-monitor-src на .176.
hard-panel-176 online. Root-SSH на VM включён (PermitRootLogin yes, пароль задан).${GHARD_ADMIN_TOKEN-}. Проверено: GET /api/v1/servers без токена отдаёт hard-panel-176 online./root/deploy-hard-monitor.sh, /root/fix-remaining.sh на .176.:slave, добавлены в мониторинг — все online.gnsynapse (192.168.1.172, панель id 46) — агент установлен через scp из /opt/hard-monitor-src + install.sh (navi rei). Флот 19/19 online.edb6cff..b6080d0 (19 коммитов, v1.30.0): gnexus-auth (OAuth PKCE), ui-kit 1.0 Verdant, health-чекер сервисов, журнал событий, Synapse-интеграция, i18n, MCP agent_guide (navi rei). Бэкапы БД в volume; конфликт compose разрешён, локальные правки сохранены.b6080d0..40a8810 — персональные MCP-ключи: страница /mcp-keys, гард require_mcp, таблица mcp_tokens, миграции users (+system_role, +blocked) (navi rei). Бэкап снят, pull без конфликтов, флот 19/19./auth/login → 302 на auth.gnexus.space, API/webhook без сессии/подписи → 401 (navi rei). Креды OAuth-клиента в gnexus-creds (hard-panel gnexus-auth OAuth client).