diff --git a/10-systems/hosts/tgclientmcp.md b/10-systems/hosts/tgclientmcp.md index 8456203..9d49f27 100644 --- a/10-systems/hosts/tgclientmcp.md +++ b/10-systems/hosts/tgclientmcp.md @@ -87,7 +87,7 @@ - Подключение агента: `claude mcp add --transport http tgclient https://tgclientmcp.gnexus.space/mcp-protocol/ --header "Authorization: Bearer mcp_..."` -## Deploy fixes (2026-10-05, rei) — баги в репо, исправлены локально на хосте +## Deploy fixes & features (2026-10-05, rei) — изменения в репо, живут локально на хосте 1. **backend/Dockerfile:** `COPY frontend/package.json frontend/.npmrc ./` — не копировался `package-lock.json`, `npm ci` падал. Исправлено: @@ -110,8 +110,21 @@ `@property session → self._client.session`. Попутно добавлен диагностический лог `[login] send_code_request ok: sent=…` (тип доставки кода от Telegram — SentCodeTypeApp/SentCodeTypeSms/Call). +5. **Фича: автоотмена зависших логинов** (запрос владельца: «если через + 15 минут начала процесса входа сессия так и не была создана — отменить»). + Фоновый sweeper `login_sweeper_loop` (main.py, интервал 30 с, таск в + lifespan с graceful cancel) каждые 30 с вызывает + `login_flow.purge_stale_logins()`: pending-логины старше + `TGCLIENT_LOGIN_STALE_MINUTES` (config.py, default 15) минут от + `created_at` отменяются как ручная DELETE — `_cleanup` (строка в БД + + disconnect RAM-клиента, иначе зомби-коннект к Telegram), лог + `[login] auto-cancel stale login (age > 15m, step=…)`. + `auth.purge_expired` больше НЕ удаляет login_sessions — sweeper + единственный владелец их очистки (GC по expires_at disconnect не делал). + Верифицировано живым тестом: тестовая строка с created_at=now-20min + вычищена sweeper'ом за 40 с, лог подтверждён. -Все четыре фикса в git НЕ закоммичены — живут только в рабочей копии на +Все пять изменений в git НЕ закоммичены — живут только в рабочей копии на хосте; при `git pull` поверх могут затереться (проверять при обновлении). Стоит отправить в репозиторий. @@ -120,10 +133,17 @@ - Свежесозданному api_id Telegram может молча не доставлять код (сервер отвечает SentCodeTypeApp «отправил», но в чат 777000 ничего не приходит) — антиабьюз-прогрев, лечится временем (~час). После прогрева код приходит - в приложение (чат «Telegram»/777000), SMS не используется. + в приложение (чат «Telegram»/777000), SMS не используется. Наблюдение + 2026-10-05: 6 отправок подряд — доставилась 1; троттлинг на уровне + api_id, завершение сессий аккаунта с телефона на него не влияет. - Повторный POST /logins на неистёкшую pending-сессию того же user+phone возвращает её БЕЗ повторной send_code (защита от флуда) — для реотправки сначала DELETE /accounts/logins/{id}. +- **Автоотмена (фича #5):** pending-логин старше 15 мин от created_at + вычищается sweeper'ом (30-секундный цикл). Критерий — created_at, НЕ + expires_at: продление expires_at в БД вручную больше не спасает сессию + от автоотмены. Для нового логина после автоотмены — свежий + POST /accounts/logins (новая send_code). - Диагностическая сессия для API-вызовов без браузера: строка в таблице sessions (id hex, user_id='1', expires_at +1h) + заголовок `Cookie: tgclient_session=` (имя cookie — SESSION_COOKIE в auth.py). @@ -134,6 +154,10 @@ superadmin) не задан; персональные MCP-ключи `mcp_*` выпускаются на странице «MCP-ключи» SPA (plaintext показывается один раз). - TGCLIENT_SYNAPSE_* пусты — отчёты в Synapse не настроены. +- Логин аккаунта владельца (+380632912932) не завершён: Telegram троттлит + доставку кода на api_id (см. login notes); ждём прогрев, затем одна + свежая отправка. План Б — QR-логин (telethon 1.45.0 qr_login, требует + временного хака: в сервисе нет QR-эндпоинта). ## Listening ports (TCP, verified 2026-10-05) @@ -144,8 +168,8 @@ - Обновление сервиса: `cd /home/ubuntu/tgclient-mcp && git pull --ff-only && docker compose up -d --build` (docker через sudo; сборка ~1 мин; после - pull проверить, что четыре локальных фикса из раздела Deploy fixes не - затёрлись). + pull проверить, что пять локальных изменений из раздела Deploy fixes & + features не затёрлись). - 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/90-maintenance/pending-changes/20261005221801-69f7435e.json b/90-maintenance/pending-changes/20261005221801-69f7435e.json new file mode 100644 index 0000000..14b0244 --- /dev/null +++ b/90-maintenance/pending-changes/20261005221801-69f7435e.json @@ -0,0 +1,19 @@ +{ + "id": "20261005221801-69f7435e", + "kind": "doc", + "target": "10-systems/hosts/tgclientmcp.md", + "summary": "tgclientmcp: фича #5 автоотмена логинов (sweeper) + заметки", + "reason": "Реализована и верифицирована фича автоотмены зависших логинов (запрос владельца): sweeper 30с, критерий created_at+15мин, disconnect RAM-клиента; auth.purge_expired больше не чистит login_sessions", + "payload": { + "content": "---\ntitle: \"VPS tgclientmcp (tgclient-mcp)\"\ntype: host\nip: 192.168.1.171\npurpose: \"tgclient-mcp — мульти-аккаунтный Telegram-клиент (Telethon) + MCP-сервер + SPA-админка в home LAN\"\nowner: gmikcon\nstatus: active\nconfidence: \"90\"\nlast_reviewed: \"2026-10-05\"\nreview_interval: \"90d\"\nsource_of_truth: \"ssh-host-and-owner-confirmed\"\n---\n\n# VPS tgclientmcp (tgclient-mcp)\n\n## Overview\n\nHome LAN VPS (KVM/QEMU guest). Выделен владельцем 2026-10-05 из свободного\nдиапазона 192.168.1.170–180 (скан nmap: свободны были .171/.174/.180).\nХостит **tgclient-mcp** — Telegram-клиент формата MCP для экосистемы Gnexus:\nмульти-аккаунтный MTProto юзер-клиент (Telethon), MCP-сервер для ИИ-агентов\n(`/mcp-protocol/`) и SPA-админка с персональными MCP-токенами.\n\n## Technical Details\n\n- **IP:** 192.168.1.171 (статический, назначен владельцем)\n- **Hostname:** tgclientmcp\n- **OS:** Ubuntu 22.04.5 LTS\n- **Platform:** KVM guest, 1.9 GiB RAM, 15G root disk (47% занято на деплой)\n- **User:** ubuntu (SSH + sudo, пароль getroot88)\n- **Firewall:** ufw не активен\n- **Docker:** 29.1.3 (предустановлен), docker compose plugin 2.40.3 (пакет\n docker-compose-v2 установлен 2026-10-05 navi rei)\n\n## tgclient-mcp (deployed 2026-10-05)\n\n- **Repo:** /home/ubuntu/tgclient-mcp\n (https://git.gnexus.space/git/root/tgclient-mcp.git), branch `master`,\n HEAD 4b5e242\n- **Stack:** docker compose, один сервис `tgclient` (multi-stage build:\n SPA node:22-slim → backend python:3.12-slim + uvicorn), volume `data:/data`\n (SQLite aiosqlite WAL — единственное состояние)\n- **Port:** 8710 (host) → 8000 (container), 0.0.0.0\n- **Public URL:** https://tgclientmcp.gnexus.space (TLS на internal-proxy-vps\n .226, отдельный LE-сертификат до 2027-01-03; upstream http://192.168.1.171:8710)\n- **Endpoints:**\n - SPA: https://tgclientmcp.gnexus.space/ (200 text/html)\n - health: https://tgclientmcp.gnexus.space/api/v1/health →\n `{\"status\":\"ok\",\"version\":\"0.1.0\",\"accounts\":{...},\"db\":\"ok\"}`\n - MCP: https://tgclientmcp.gnexus.space/mcp-protocol/ (streamable HTTP,\n stateless + json_response; initialize без токена → 200 с serverInfo\n tgclient; тулы требуют Bearer `mcp_*` или admin-токен)\n- **Config:** /home/ubuntu/tgclient-mcp/.env (chmod 600, из .env.example).\n - **Telegram API заполнены 2026-10-05** (владелец получил на my.telegram.org,\n физлицо, бесплатно; апка-регистрация старая — CONAssistantApp, ~8 лет,\n это нормально: api_id идентифицирует приложение, не аккаунт):\n TGCLIENT_API_ID=24357013, TGCLIENT_API_HASH — в .env и в gnexus-creds\n secret \"tgclient-mcp Telegram API (api_id/api_hash)\"\n (id d5d70390-a058-4399-add8-539d71c9e1de). Один набор на деплой.\n - **SSO gnexus-auth настроен 2026-10-05** (креды выдал владелец):\n TGCLIENT_AUTH_BASE_URL=https://auth.gnexus.space,\n TGCLIENT_AUTH_CLIENT_ID=gnx_207OcTjCYgqSQJwuTO2V5ks0EB1GftA0,\n TGCLIENT_AUTH_REDIRECT_URI=https://tgclientmcp.gnexus.space/auth/callback,\n client_secret и webhook secret — в .env и в gnexus-creds secret\n \"tgclient-mcp SSO gnexus-auth (OAuth client)\"\n (id 935a3ff1-f9c5-4738-9da5-83fdafb5fd70).\n TGCLIENT_AUTH_ALLOWLIST пуст — пускается любой залогиненный gnexus-auth.\n - Всё ещё НЕ заполнены: TGCLIENT_ADMIN_TOKEN, TGCLIENT_SYNAPSE_*.\n - GOTCHA: `TGCLIENT_API_ID=` пустая строка ломает pydantic int — при\n ротации не оставлять строку пустой, комментировать или вписывать число.\n- **Креды хоста:** gnexus-creds secret \"tgclient-mcp host SSH (192.168.1.171)\"\n (id 70fb91b3-85f0-479c-9ecb-ba009299417f).\n\n## SSO flow (verified 2026-10-05)\n\n- `GET /auth/login` → 302 на\n `https://auth.gnexus.space/oauth/authorize?response_type=code&client_id=…&redirect_uri=https%3A%2F%2Ftgclientmcp.gnexus.space%2Fauth%2Fcallback&state=…&code_challenge=…&code_challenge_method=S256&scope=openid+email+profile+roles+permissions&return_to=/`\n (PKCE S256; gnexus-auth показывает страницу Sign in — клиент принят).\n- `GET /auth/callback?code&state` — обмен кода (client_secret + PKCE\n verifier), сессия в cookie (secure, т.к. redirect_uri https), redirect на\n return_to. Фейковый state → 400 «Invalid or expired OAuth state».\n- `POST /webhooks/gnexus-auth` (+ вариант с trailing slash) — события\n gnexus-auth (HMAC-подпись через TGCLIENT_AUTH_WEBHOOK_SECRET); без подписи\n → 401 «invalid webhook signature».\n- Внутренние httpx-запросы к gnexus-auth идут с verify=False (сервис в LAN,\n TLS терминируется на .226) — это осознанное решение из кода репо.\n- Подключение агента: `claude mcp add --transport http tgclient\n https://tgclientmcp.gnexus.space/mcp-protocol/ --header \"Authorization: Bearer mcp_...\"`\n\n## Deploy fixes & features (2026-10-05, rei) — изменения в репо, живут локально на хосте\n\n1. **backend/Dockerfile:** `COPY frontend/package.json frontend/.npmrc ./` —\n не копировался `package-lock.json`, `npm ci` падал. Исправлено:\n `COPY frontend/package.json frontend/package-lock.json frontend/.npmrc ./`.\n2. **backend/app/tg/manager.py:** `NameError: TelegramClient` — класс\n используется в аннотациях, но не импортирован. Исправлено:\n `from telethon import TelegramClient, errors`.\n3. **backend/app/mcp/server.py:** FastMCP (mcp-sdk 1.30.0) при дефолтном\n host=127.0.0.1 автоматически включает DNS-rebinding защиту с\n allowed_hosts только 127.0.0.1/localhost/[::1] — любой запрос через\n домен получал 421 «Invalid Host header». Исправлено: в конструктор\n FastMCP добавлен\n `transport_security=TransportSecuritySettings(enable_dns_rebinding_protection=False)`\n (сервис за nginx с собственным гардом require_mcp — защита не нужна).\n4. **backend/app/tg/login_flow.py:** `AttributeError:\n 'TelegramClientWithSession' object has no attribute 'session'` — враппер\n логин-клиента не экспонировал `.session`, `_finalize` падал сразу после\n успешного sign_in (Telegram авторизацию засчитывал, сессия терялась,\n аккаунт не записывался в БД). Исправлено: добавлен\n `@property session → self._client.session`. Попутно добавлен\n диагностический лог `[login] send_code_request ok: sent=…` (тип доставки\n кода от Telegram — SentCodeTypeApp/SentCodeTypeSms/Call).\n5. **Фича: автоотмена зависших логинов** (запрос владельца: «если через\n 15 минут начала процесса входа сессия так и не была создана — отменить»).\n Фоновый sweeper `login_sweeper_loop` (main.py, интервал 30 с, таск в\n lifespan с graceful cancel) каждые 30 с вызывает\n `login_flow.purge_stale_logins()`: pending-логины старше\n `TGCLIENT_LOGIN_STALE_MINUTES` (config.py, default 15) минут от\n `created_at` отменяются как ручная DELETE — `_cleanup` (строка в БД +\n disconnect RAM-клиента, иначе зомби-коннект к Telegram), лог\n `[login] auto-cancel stale login (age > 15m, step=…)`.\n `auth.purge_expired` больше НЕ удаляет login_sessions — sweeper\n единственный владелец их очистки (GC по expires_at disconnect не делал).\n Верифицировано живым тестом: тестовая строка с created_at=now-20min\n вычищена sweeper'ом за 40 с, лог подтверждён.\n\nВсе пять изменений в git НЕ закоммичены — живут только в рабочей копии на\nхосте; при `git pull` поверх могут затереться (проверять при обновлении).\nСтоит отправить в репозиторий.\n\n## Telegram login notes (2026-10-05)\n\n- Свежесозданному api_id Telegram может молча не доставлять код (сервер\n отвечает SentCodeTypeApp «отправил», но в чат 777000 ничего не приходит) —\n антиабьюз-прогрев, лечится временем (~час). После прогрева код приходит\n в приложение (чат «Telegram»/777000), SMS не используется. Наблюдение\n 2026-10-05: 6 отправок подряд — доставилась 1; троттлинг на уровне\n api_id, завершение сессий аккаунта с телефона на него не влияет.\n- Повторный POST /logins на неистёкшую pending-сессию того же user+phone\n возвращает её БЕЗ повторной send_code (защита от флуда) — для реотправки\n сначала DELETE /accounts/logins/{id}.\n- **Автоотмена (фича #5):** pending-логин старше 15 мин от created_at\n вычищается sweeper'ом (30-секундный цикл). Критерий — created_at, НЕ\n expires_at: продление expires_at в БД вручную больше не спасает сессию\n от автоотмены. Для нового логина после автоотмены — свежий\n POST /accounts/logins (новая send_code).\n- Диагностическая сессия для API-вызовов без браузера: строка в таблице\n sessions (id hex, user_id='1', expires_at +1h) + заголовок\n `Cookie: tgclient_session=` (имя cookie — SESSION_COOKIE в auth.py).\n\n## Pending\n\n- TGCLIENT_ADMIN_TOKEN пуст — статический супер-токен для скриптов (роль\n superadmin) не задан; персональные MCP-ключи `mcp_*` выпускаются на\n странице «MCP-ключи» SPA (plaintext показывается один раз).\n- TGCLIENT_SYNAPSE_* пусты — отчёты в Synapse не настроены.\n- Логин аккаунта владельца (+380632912932) не завершён: Telegram троттлит\n доставку кода на api_id (см. login notes); ждём прогрев, затем одна\n свежая отправка. План Б — QR-логин (telethon 1.45.0 qr_login, требует\n временного хака: в сервисе нет QR-эндпоинта).\n\n## Listening ports (TCP, verified 2026-10-05)\n\n- 22 — sshd\n- 8710 — tgclient docker (0.0.0.0)\n\n## Notes\n\n- Обновление сервиса: `cd /home/ubuntu/tgclient-mcp && git pull --ff-only &&\n docker compose up -d --build` (docker через sudo; сборка ~1 мин; после\n pull проверить, что пять локальных изменений из раздела Deploy fixes &\n features не затёрлись).\n- nginx-сайт на .226: /etc/nginx/sites-available/tgclientmcp.gnexus.space\n (:80 + :443, client_max_body_size 32m, на /mcp-protocol/ proxy_buffering\n off + proxy_read_timeout 300s)." + }, + "status": "applied", + "created_at": "2026-10-05T22:18:01Z", + "updated_at": "2026-10-05T22:18:03Z", + "applied_at": "2026-10-05T22:18:03Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}