diff --git a/10-systems/hosts/tgclientmcp.md b/10-systems/hosts/tgclientmcp.md index 367c8d0..ad4e258 100644 --- a/10-systems/hosts/tgclientmcp.md +++ b/10-systems/hosts/tgclientmcp.md @@ -15,10 +15,9 @@ ## Overview -Home LAN VPS (KVM/QEMU guest, MAC 52:54:00:xx — из того же libvirt-пула, что и -остальные VM). Выделен владельцем 2026-10-05 из свободного диапазона -192.168.1.170–180 (скан nmap: свободны были .171/.174/.180). Хостит -**tgclient-mcp** — Telegram-клиент формата MCP для экосистемы Gnexus: +Home LAN VPS (KVM/QEMU guest). Выделен владельцем 2026-10-05 из свободного +диапазона 192.168.1.170–180 (скан nmap: свободны были .171/.174/.180). +Хостит **tgclient-mcp** — Telegram-клиент формата MCP для экосистемы Gnexus: мульти-аккаунтный MTProto юзер-клиент (Telethon), MCP-сервер для ИИ-агентов (`/mcp-protocol/`) и SPA-админка с персональными MCP-токенами. @@ -42,33 +41,43 @@ SPA node:22-slim → backend python:3.12-slim + uvicorn), volume `data:/data` (SQLite aiosqlite WAL — единственное состояние) - **Port:** 8710 (host) → 8000 (container), 0.0.0.0 +- **Public URL:** https://tgclientmcp.gnexus.space (TLS на internal-proxy-vps + .226, отдельный LE-сертификат до 2027-01-03; upstream http://192.168.1.171:8710) - **Endpoints:** - - SPA: http://192.168.1.171:8710/ (200 text/html) - - health: http://192.168.1.171:8710/api/v1/health → + - SPA: https://tgclientmcp.gnexus.space/ (200 text/html) + - health: https://tgclientmcp.gnexus.space/api/v1/health → `{"status":"ok","version":"0.1.0","accounts":{...},"db":"ok"}` - - MCP: http://192.168.1.171:8710/mcp-protocol/ (streamable HTTP; GET без - MCP-заголовков → 406 — норма) + - MCP: https://tgclientmcp.gnexus.space/mcp-protocol/ (streamable HTTP, + stateless + json_response; initialize без токена → 200 с serverInfo + tgclient; тулы требуют Bearer `mcp_*` или admin-токен) - **Config:** /home/ubuntu/tgclient-mcp/.env (chmod 600, из .env.example). На момент деплоя НЕ заполнены (сервис работает, но добавление Telegram- аккаунтов недоступно): TGCLIENT_API_ID/_API_HASH (my.telegram.org), TGCLIENT_ADMIN_TOKEN, TGCLIENT_AUTH_* (SSO), TGCLIENT_SYNAPSE_*. - GOTCHA: `TGCLIENT_API_ID=` пустая строка ломает pydantic int — строку - закомментировали; при заполнении вписать число и раскомментировать. -- **Креды:** gnexus-creds secret "tgclient-mcp host SSH (192.168.1.171)". + GOTCHA: `TGCLIENT_API_ID=` пустая строка ломает pydantic int — строка + закомментирована; при заполнении вписать число и раскомментировать. +- **Креды:** gnexus-creds secret "tgclient-mcp host SSH (192.168.1.171)" + (id 70fb91b3-85f0-479c-9ecb-ba009299417f). ## Deploy fixes (2026-10-05, rei) — баги в репо, исправлены локально на хосте 1. **backend/Dockerfile:** `COPY frontend/package.json frontend/.npmrc ./` — не копировался `package-lock.json`, `npm ci` падал. Исправлено: `COPY frontend/package.json frontend/package-lock.json frontend/.npmrc ./`. - В git НЕ закоммичено — при `git pull` поверх может затереться; при - обновлении проверить строку COPY. 2. **backend/app/tg/manager.py:** `NameError: TelegramClient` — класс используется в аннотациях, но не импортирован. Исправлено: - `from telethon import TelegramClient, errors`. В git НЕ закоммичено — - та же оговорка. + `from telethon import TelegramClient, errors`. +3. **backend/app/mcp/server.py:** FastMCP (mcp-sdk 1.30.0) при дефолтном + host=127.0.0.1 автоматически включает DNS-rebinding защиту с + allowed_hosts только 127.0.0.1/localhost/[::1] — любой запрос через + домен получал 421 «Invalid Host header». Исправлено: в конструктор + FastMCP добавлен + `transport_security=TransportSecuritySettings(enable_dns_rebinding_protection=False)` + (сервис за nginx с собственным гардом require_mcp — защита не нужна). -Оба фикса стоит отправить в репозиторий (или дождаться апстрима). +Все три фикса в git НЕ закоммичены — живут только в рабочей копии на хосте; +при `git pull` поверх могут затереться (проверять при обновлении). Стоит +отправить в репозиторий. ## SSO / MCP-ключи (pending) @@ -78,7 +87,7 @@ (plaintext показывается один раз). Статический TGCLIENT_ADMIN_TOKEN — супер-бэкдор для скриптов (роль superadmin), пока пуст. - Подключение агента: `claude mcp add --transport http tgclient - http://192.168.1.171:8710/mcp-protocol/ --header "Authorization: Bearer mcp_..."` + https://tgclientmcp.gnexus.space/mcp-protocol/ --header "Authorization: Bearer mcp_..."` ## Listening ports (TCP, verified 2026-10-05) @@ -88,6 +97,8 @@ ## Notes - Обновление сервиса: `cd /home/ubuntu/tgclient-mcp && git pull --ff-only && - docker compose up -d --build` (docker через sudo; сборка ~1 мин). -- Публичный URL (https://tgclient.gnexus.space через nginx на .226) — не - настроен, по согласованию с владельцем. + docker compose up -d --build` (docker через sudo; сборка ~1 мин; после + pull проверить, что три локальных фикса из раздела Deploy fixes не затёрлись). +- nginx-сайт на .226: /etc/nginx/sites-available/tgclientmcp.gnexus.space + (:80 + :443, client_max_body_size 32m, на /mcp-protocol/ proxy_buffering + off + proxy_read_timeout 300s). diff --git a/10-systems/servers/internal-proxy-vps.md b/10-systems/servers/internal-proxy-vps.md index 8cfe2d6..b919848 100644 --- a/10-systems/servers/internal-proxy-vps.md +++ b/10-systems/servers/internal-proxy-vps.md @@ -1,7 +1,7 @@ --- owner: gmikcon status: active -last_reviewed: 2026-09-21 +last_reviewed: 2026-10-05 review_interval: 90d confidence: high source_of_truth: ssh-host-verified @@ -61,7 +61,7 @@ The nginx proxy handles the `gnexus.space` domain family. -Enabled nginx sites (verified 2026-09-21): +Enabled nginx sites (verified 2026-10-05): - `auth.gnexus.space` - `bugtrail.gnexus.space` @@ -71,9 +71,12 @@ - `fuckjira.gnexus.space` - `git.gnexus.space` - `gnexus.space` +- `hpanel.gnexus.space` - `jellyfin.gnexus.space` - `navi.gnexus.space` +- `synapse.gnexus.space` - `tasks.gnexus.space` +- `tgclientmcp.gnexus.space` - `transcribe-demo.gnexus.space` - `transmission.gnexus.space` - `vmk-marginator.gnexus.space` @@ -103,9 +106,12 @@ | `fuckjira.gnexus.space` | `http://192.168.1.175:8080` | | `git.gnexus.space` | `http://192.168.1.156` | | `gnexus.space` | `http://192.168.1.151` | +| `hpanel.gnexus.space` | `http://192.168.1.176:8000` | | `jellyfin.gnexus.space` | `http://192.168.1.153:8096` | | `navi.gnexus.space` | `http://192.168.1.168:8000` | +| `synapse.gnexus.space` | `http://192.168.1.172:8013` | | `tasks.gnexus.space` | `http://192.168.1.179:8135` | +| `tgclientmcp.gnexus.space` | `http://192.168.1.171:8710` | | `transcribe-demo.gnexus.space` | `http://192.168.1.75:5173` | | `transmission.gnexus.space` | `http://192.168.1.154:3000` | | `vmk-marginator.gnexus.space` | `http://192.168.1.178:8080` | @@ -122,8 +128,8 @@ ## TLS Certificates (certbot) - Separate certbot certificate for `bugtrail.gnexus.space` issued 2026-09-18 (nginx authenticator, http-01). Files: `/etc/letsencrypt/live/bugtrail.gnexus.space/fullchain.pem` and `privkey.pem`, valid until 2026-12-17, CN=bugtrail.gnexus.space, issuer Let's Encrypt (YR2). -- The `bugtrail.gnexus.space` nginx site has both an HTTP :80 block (no redirect) and an HTTPS :443 block using the dedicated certificate, both proxying to `http://192.168.1.177:80` with standard proxy headers. - Separate certbot certificate for `tasks.gnexus.space` issued 2026-09-21 (nginx authenticator, http-01). Files: `/etc/letsencrypt/live/tasks.gnexus.space/fullchain.pem` and `privkey.pem`, valid until 2026-12-20. Site `tasks.gnexus.space` proxies to `http://192.168.1.179:8135` (gntodo stack): :80 block (no redirect) + :443 block with the dedicated certificate, `client_max_body_size 12m`, `proxy_set_header Host $host` (required — /mcp Host check), `X-Forwarded-Proto https`, and `proxy_buffering off` + `proxy_read_timeout 300s` on `/api/` and `/mcp/` (SSE). Site created by the Proxy navi instance, :443 block completed by rei (2026-09-21). +- Separate certbot certificate for `tgclientmcp.gnexus.space` issued 2026-10-05 (nginx authenticator, http-01, by navi rei). Files: `/etc/letsencrypt/live/tgclientmcp.gnexus.space/fullchain.pem` and `privkey.pem`, valid until 2027-01-03. Site `tgclientmcp.gnexus.space` proxies to `http://192.168.1.171:8710` (tgclient-mcp): :80 block (no redirect) + :443 block with the dedicated certificate, `client_max_body_size 32m` (media 20 MB + base64 overhead), `proxy_set_header Host $host`, `X-Forwarded-Proto https`, and `proxy_buffering off` + `proxy_read_timeout 300s` on `/mcp-protocol/` (MCP streamable HTTP). Deploy note: first certbot run glued the :443 directives into the :80 server block — the site was rewritten into two clean blocks (tasks.gnexus.space style). - Other sites use the shared `gnexus.space` multi-SAN certificate (10 SANs, unchanged by this work). No raw credentials are documented here.