[2026-06-04] kraken: family/projects/aide-kraken-backend.md

family/projects/aide-kraken-backend.md

@@ -1,7 +1,7 @@
 # Aide → Kraken Backend: план настройки
 
 > Создано: 2026-05-13  
-> Статус: ✅ работает
+> Статус: ✅ работает (Aide + SpeakGPT)
 
 ## Цель
 
@@ -92,6 +92,41 @@ curl -s https://kraken.qentra.top/health
 | API Key | секрет из config.yaml |
 | Model | `hermes-agent` (или любое — маппится на Hermes) |
 
+### Шаг 4 — Настроить SpeakGPT
+
+В SpeakGPT → Settings → API:
+
+| Поле | Значение |
+|------|----------|
+| Base URL | `https://kraken.qentra.top/v1` |
+| API Key | секрет из config.yaml |
+| Model | `hermes-agent` |
+
+> **Важно:** Base URL обязательно должен заканчиваться на `/v1`, иначе SpeakGPT стучится в корень `/chat/completions`, который не существует.
+
+---
+
+## Заметки по эксплуатации
+
+### Туннель нестабилен — `sendmsg: network is unreachable`
+
+Иногда после старта cloudflared начинает циклически падать с ошибкой `write udp: sendmsg: network is unreachable` — проблема с IPv6/UDP на RPi5.
+
+**Решение:** пересоздать контейнер с флагом `--protocol http2`:
+```bash
+docker run --rm --network host cloudflare/cloudflared tunnel --no-autoupdate --protocol http2 run --token <TOKEN>
+```
+
+После запуска проверить 4/4 Registered в логах.
+
+### После пересоздания cloudflared — Cloudflare может выдать 403
+
+При смене connector ID (после пересоздания контейнера) Cloudflare WAF может начать блокировать запросы с незнакомых IP. Запросы с телефона (Aide, SpeakGPT) обычно проходят, так как используют мобильный User-Agent.
+
+Если 403 — проверить Cloudflare Zero Trust Dashboard:
+- **Access → Applications** — нет ли лишних правил для `kraken.qentra.top`
+- Или просто подождать — кэш обновляется
+
 ---
 
 ## О cloudflared