From 86fef55a24ed8baffe7e184e05724f2e3c6b1975 Mon Sep 17 00:00:00 2001
From: Taiga <taiga@hermes>
Date: Thu, 4 Jun 2026 18:01:16 +0000
Subject: [PATCH] [2026-06-04] taiga-vault:
 family/projects/aide-kraken-backend.md

---
 family/projects/aide-kraken-backend.md | 37 +++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/family/projects/aide-kraken-backend.md b/family/projects/aide-kraken-backend.md
index 495de78b..b9d160d7 100644
--- a/family/projects/aide-kraken-backend.md
+++ b/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