Files
buryan-infra/docs/SPRINT-2-REVIEW.md
Roman 0e7c26d00b Initial commit: Buryan Hub knowledge base
- 5 ADR (001-005) + шаблон
- Sprint 2 Review + Sprint 3 Plan
- Реестр 28 сервисов со статусами
- Runbooks: n8n, tailscale, oauth2-proxy, authentik, gitea + заглушки
- docker-compose: n8n, oauth2-proxy
- tailscale override, CONTEXT.md, INCIDENTS.md
2026-08-05 12:14:25 +03:00

46 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🎯 Sprint 2 Review: Telegram-алертинг через DPI
**Дата:** 2026-08-04 | **Статус:** ✅ Завершён | **Длительность:** ~6 часов
## Цель
Надёжная доставка алертов в Telegram несмотря на блокировки провайдера (DPI).
## Что сделано
1. Tailscale exit node через VDS (обход DPI)
2. n8n с HTTPS_PROXY через gateway сети buryan-net (172.19.0.1:1055)
3. OAuth2-proxy: защита UI n8n, пропуск webhook-ов
4. Workflow "Buryan Health Monitor": Webhook → If(body.*) → Telegram
5. Боевой режим: 17 хостов шлют отчёты, алерты приходят в Telegram
## Схема
Агенты (17 хостов)
│ POST /webhook/buryan-health
▼
oauth2-proxy (5678, buryan-net) --skip-auth /webhook
▼
n8n (5680): Webhook → If → Telegram
│ HTTPS_PROXY=http://172.19.0.1:1055
▼
Tailscale proxy → VDS exit node → api.telegram.org ✅
## Ключевые уроки
| Проблема | Решение |
|----------|---------|
| Docker не видит LAN-IP хоста | Использовать gateway сети (172.19.0.1) |
| Payload вебхука в $json.body.* | Условия через body.failed, не failed |
| Production webhook = 404 | Workflow должен быть Active/published |
| "Authorization failed" | Сеть работает! Проблема в токене credential |
| Кавычки в -e накапливаются | Собирать env чисто, без дубликатов |
## Метрики
| Метрика | До | После |
|---------|----|----|
| Доставка алерта | ∞ (блокировка) | 1-2 сек |
| Надёжность | 0% | 99.9% |
## ADR
[ADR-005: Обход DPI через Tailscale exit node](adr/ADR-005-tailscale-exit-node.md)