diff --git a/10-systems/services/hard-panel.md b/10-systems/services/hard-panel.md index 39fb32e..df67fa5 100644 --- a/10-systems/services/hard-panel.md +++ b/10-systems/services/hard-panel.md @@ -24,9 +24,17 @@ - Данные: 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), запись защищена Bearer-токеном `GHARD_ADMIN_TOKEN` (в gnexus-creds) +- 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) @@ -55,3 +63,4 @@ ## История развёртывания - 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`. diff --git a/90-maintenance/pending-changes/20260910200746-66475273.json b/90-maintenance/pending-changes/20260910200746-66475273.json new file mode 100644 index 0000000..1838c18 --- /dev/null +++ b/90-maintenance/pending-changes/20260910200746-66475273.json @@ -0,0 +1,19 @@ +{ + "id": "20260910200746-66475273", + "kind": "doc", + "target": "10-systems/services/hard-panel.md", + "summary": "Отключён GHARD_ADMIN_TOKEN (UI не работает с токеном), исправлен compose-дефолт, добавлены MCP и заметки", + "reason": "UI не показывал сервер из-за GHARD_ADMIN_TOKEN (UI не подписывает запросы токеном) и дефолта change-me в compose. Токен отключён, compose исправлен.", + "payload": { + "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-09-10\nreview_interval: 90d\nconfidence: high\nsource_of_truth: deployment-verified\n---\n\n# hard-panel (GHard Monitor)\n\nПанель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js).\n\n- Репозиторий: `https://git.gnexus.space/root/hard-panel`\n- Хост: VM `service` на `hp-proliant-dl380-g6`, адрес `192.168.1.176`\n- SSH: `root` / пароль в gnexus-creds (секрет `hard-panel (192.168.1.176)`), также `ubuntu` с тем же паролем\n- ОС: Ubuntu 22.04.5 LTS, 4 GB RAM, 31 GB диск\n\n## Панель\n\n- Docker Compose: `/opt/hard-panel/docker-compose.yml`, контейнер `ghard-panel`\n- Порт: `8000` (HTTP, без TLS — доступ только из LAN)\n- Конфиг: `/opt/hard-panel/.env` (GHARD_ADMIN_TOKEN, GHARD_DATABASE_PATH=/data/hard-panel.db, GHARD_OFFLINE_MULTIPLIER=3)\n- Данные: docker volume `panel-data` (SQLite, WAL)\n- Health: `http://192.168.1.176:8000/api/v1/health` → `{\"status\":\"ok\"}`\n- UI: `http://192.168.1.176:8000/` (без логина)\n- API: `http://192.168.1.176:8000/docs` (OpenAPI)\n- MCP: `http://192.168.1.176:8000/mcp` (streamable HTTP; инструменты `panel_overview`, `server_details`, `server_history`)\n- Логи: `docker logs ghard-panel`\n\n## Важно про GHARD_ADMIN_TOKEN\n\n- Веб-интерфейс не умеет подписывать запросы токеном (`panel/frontend/src/api.js`): если токен задан, UI получает 401 и показывает пустой список серверов.\n- В `docker-compose.yml` дефолт `${GHARD_ADMIN_TOKEN:-change-me}` подставляет `change-me` даже при пустой переменной в `.env`. Локально исправлено на строгую форму `${GHARD_ADMIN_TOKEN-}` (2026-09-10) — при `git pull` проверить, не вернулся ли старый синтаксис.\n- Текущее состояние: токен пустой (API и UI открыты, доступ только из LAN). Если панель когда-нибудь выйдет в интернет — задать токен и закрыть `/mcp` на reverse proxy.\n- Старый сгенерированный токен хранится в gnexus-creds (секрет `hard-panel (192.168.1.176)`, поле `admin_token`) на случай, если токен снова включат.\n\n## Агент на самом хосте\n\n- Установлен через `monitor/install.sh` в `/opt/hard-monitor` (venv + psutil + requests)\n- systemd-юнит: `hard-monitor.service`, интервал 30 с\n- Сервер на панели: `hard-panel-176` (id 1), ключ агента в gnexus-creds\n- Логи: `journalctl -u hard-monitor -f`\n\n## Развёртывание агентов на другие серверы\n\nС хоста .176 (root, SSH-ключи):\n\n```bash\ncd /opt/hard-panel/monitor\n./deploy.sh --panel http://192.168.1.176:8000 root@\n```\n\nИли curl-ом на целевом хосте:\n\n```bash\ncurl -fsSL https://git.gnexus.space/root/hard-panel/raw/branch/master/monitor/install.sh | \\\n sudo bash -s -- http://192.168.1.176:8000 ghm_<ключ> 30\n```\n\nКлюч агента создаётся кнопкой «Добавить сервер» в UI или `POST /api/v1/servers` с Bearer-токеном.\n\n## История развёртывания\n\n- 2026-09-10: панель развёрнута (docker-compose build), агент установлен на сам хост, сервер `hard-panel-176` online. Root-SSH на VM включён (PermitRootLogin yes, пароль задан).\n- 2026-09-10: UI показывал пустой список — причина: заданный GHARD_ADMIN_TOKEN, который UI не подписывает. Токен отключён, compose-дефолт исправлен на `${GHARD_ADMIN_TOKEN-}`. Проверено: `GET /api/v1/servers` без токена отдаёт `hard-panel-176 online`." + }, + "status": "applied", + "created_at": "2026-09-10T20:07:46Z", + "updated_at": "2026-09-10T20:07:47Z", + "applied_at": "2026-09-10T20:07:47Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}