---
owner: gmikcon
status: active
last_reviewed: 2026-10-04
review_interval: 90d
confidence: high
source_of_truth: ssh-host-and-live-verified
---

# Gnexus Synapse

Централизованный хаб уведомлений экосистемы Gnexus: сервисы присылают событие «что случилось», Synapse решает, кому, куда и каким каналом доставить (Telegram, Email, Push, internal log, system-to-system в Navi). Проект gntodo id 9; репозиторий `root/gn-synapse` на GitBucket.

## Identity

- Host: `gnsynapse` (192.168.1.172), VM на `hp-proliant-dl380-g6`
- Deploy path: `/home/ubuntu/gnsynapse` (git clone, HEAD 82d9181 на момент деплоя)
- Stack: docker compose (api + worker + postgres:17 + redis:7), порт хоста 8013
- Public URL: `https://synapse.gnexus.space`
- Credentials: gnexus-creds secret `gn-synapse-prod-secrets` (id 616b707b-8194-4c98-a031-374b39012e9c) — POSTGRES_PASSWORD, MCP_TOKEN; SSH хоста — secret `gnsynapse-ssh`

## Deployment (2026-10-04, navi rei)

- `docker compose up -d --build` через sudo (user ubuntu не в docker-группе — ловушка как на bugtrail).
- Alembic-миграции применяются entrypoint'ом api автоматически; голова `b7d3e8f04a92`.
- `.env` создан из `.env.example`: POSTGRES_PASSWORD и MCP_TOKEN = `openssl rand -hex`, `GAUTH_BASE_URL=https://auth.gnexus.space`, `GAUTH_VERIFY_TLS=true`, `GAUTH_REDIRECT_URI=https://synapse.gnexus.space/auth/callback`, `SYNAPSE_PORT=8013`.
- `docker-compose.override.yml` (локальная модификация, переживает git pull): extra_hosts `auth.gnexus.space:192.168.1.226` для api и worker — серверный call-home (валидация opaque-токенов через userinfo) идёт в LAN через internal-proxy, где валидный LE-сертификат. Браузерный редирект остаётся на публичный auth.gnexus.space (GAUTH_BASE_URL).

## Public entry

- Route: internet → external-vps (catch-all → internal-proxy) → nginx на `internal-proxy-vps` (.226) → `http://192.168.1.172:8013`.
- nginx site: `/etc/nginx/sites-available/synapse.gnexus.space` на .226; TLS Let's Encrypt `synapse.gnexus.space` (certbot --nginx, до 2027-01-02, автопродление); HTTP→HTTPS 301 добавлен вручную (certbot не вписал).
- DNS: wildcard `*.gnexus.space` → 51.83.131.93 (external-vps), отдельной записи не потребовалось.
- `proxy_buffering off` + `proxy_read_timeout 300s` — для SSE/MCP.

## Verified smoke (2026-10-04)

- `/api/healthz` → `{"status":"ok","service":"synapse"}`; `/api/readyz` → postgres ok, redis ok.
- Worker: `celery@... ready.` в логах.
- SPA отдаётся на `/` (Vue 3, lang=ru).
- `/mcp` без токена → 401 (MCP включён, MCP_TOKEN задан).
- Полный конвейер: source `monitoring` + type (container/down) + target `internal_log/smoke-log` + rule + API-ключ созданы через `python -m app.cli`; POST `/api/v1/events` через публичный HTTPS → 202; доставка в БД `delivered` с отрендеренным шаблоном.

## Pending (владелец, рантбук §5)

1. Зарегистрировать OAuth-клиент `synapse` в gnexus-auth: redirect URI `https://synapse.gnexus.space/auth/callback`, скоупы `openid email profile roles permissions`, вебхуки `auth.logout`/`auth.global_logout`/`session.revoked` → `https://synapse.gnexus.space/auth/webhooks`.
2. Вписать `GAUTH_CLIENT_ID`, `GAUTH_CLIENT_SECRET`, `GAUTH_WEBHOOK_SECRET` в `.env` на хосте + gnexus-creds, затем `docker compose up -d` (api пересоздастся).
3. Проверка: `curl -s localhost:8013/auth/login -o /dev/null -w '%{http_code}'` → 302/307 на authorize с реальным client_id.
4. Telegram-канал — отложен до задачи #29 (не создавать цель telegram).
5. Push-канал (VAPID) — опционально, рантбук §7.

## Operations

- Обновление: `cd /home/ubuntu/gnsynapse && git pull && sudo docker compose up -d --build` (перед этим `pg_dump` — откат миграций вниз не поддерживается всеми ревизиями).
- Бэкап БД: `sudo docker compose exec -T postgres pg_dump -U synapse synapse > backup-$(date +%F).sql`.
- MCP-управление: `https://synapse.gnexus.space/mcp` с Bearer MCP_TOKEN (31 тул, docs/07).
- Smoke-объекты приёмки (source monitoring, key smoke-key, target smoke-log, rule id=1) — можно архивировать через админку/MCP после реальной настройки.
