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
This commit is contained in:
commit
0e7c26d00b
51 files changed
+766
No files matched your search
@@ -0,0 +1,9 @@
|
|||||||
|
.env
|
||||||
|
*.sqlite*
|
||||||
|
*.db
|
||||||
|
crash.journal
|
||||||
|
n8nEventLog*
|
||||||
|
*.log
|
||||||
|
node_modules/
|
||||||
|
__pycache__/
|
||||||
|
.DS_Store
|
||||||
+55
@@ -0,0 +1,55 @@
|
|||||||
|
# 🤖 Контекст для AI-агентов
|
||||||
|
|
||||||
|
**⚠️ ЭТОТ ФАЙЛ ЧИТАТЬ ПЕРВЫМ ДЕЛОМ!**
|
||||||
|
|
||||||
|
## 📜 Правила работы
|
||||||
|
|
||||||
|
1. Перед действием: прочитай этот файл + релевантный runbook
|
||||||
|
2. После действия: обнови Git (commit с описанием)
|
||||||
|
3. Принял решение → создай ADR в docs/adr/
|
||||||
|
4. Нашёл проблему → добавь в docs/INCIDENTS.md
|
||||||
|
5. Не уверен → спроси Roman, не действуй наугад
|
||||||
|
|
||||||
|
## 🎯 Текущий статус (2026-08-05)
|
||||||
|
|
||||||
|
| Параметр | Значение |
|
||||||
|
|----------|----------|
|
||||||
|
| Уровень автоматизации | 35% |
|
||||||
|
| Сервисов онлайн | 28 |
|
||||||
|
| SSO интеграция | 13/28 |
|
||||||
|
| Активных инцидентов | 0 |
|
||||||
|
|
||||||
|
## 🚀 Текущий фокус: Sprint 3 — Умные алерты
|
||||||
|
|
||||||
|
- [ ] Дедупликация алертов (1 алерт на проблему, не на цикл)
|
||||||
|
- [ ] Rate limiting (не чаще 1 раза в 15 минут)
|
||||||
|
- [ ] Алерт "всё восстановилось ✅"
|
||||||
|
- [ ] Grafana дашборд мониторинга
|
||||||
|
|
||||||
|
## 🔑 Критичные данные
|
||||||
|
|
||||||
|
| Ресурс | IP/URL |
|
||||||
|
|--------|--------|
|
||||||
|
| PVE | 192.168.1.10 |
|
||||||
|
| Authentik | 192.168.1.114:9000 |
|
||||||
|
| n8n UI | 192.168.1.108:5680 |
|
||||||
|
| n8n Webhook | 192.168.1.108:5678 |
|
||||||
|
| Gitea | 192.168.1.140:3000 |
|
||||||
|
| Tailscale proxy | 172.19.0.1:1055 (gateway buryan-net) |
|
||||||
|
| VPS | 185.221.198.255 |
|
||||||
|
| Domain | buryans.ru |
|
||||||
|
|
||||||
|
## 🗂️ Где что лежит
|
||||||
|
|
||||||
|
- ADR (решения): docs/adr/
|
||||||
|
- Runbooks: knowledge/runbooks/
|
||||||
|
- Инциденты: docs/INCIDENTS.md
|
||||||
|
- Конфиги Docker: docker/<service>/
|
||||||
|
- Workflow n8n: workflows/
|
||||||
|
|
||||||
|
## 📞 Если что-то пошло не так
|
||||||
|
|
||||||
|
1. Проверь docs/INCIDENTS.md
|
||||||
|
2. Проверь соответствующий runbook
|
||||||
|
3. Создай новый incident
|
||||||
|
4. Уведоми Roman через Telegram (@Buryans_AlertBot)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
# 🏰 Buryan Hub — Self-Healing Home Infrastructure
|
||||||
|
|
||||||
|
Полностью автономная домашняя инфраструктура с AI-агентами.
|
||||||
|
|
||||||
|
## 📊 Current Status (2026-08-05)
|
||||||
|
|
||||||
|
| Метрика | Значение |
|
||||||
|
|---------|----------|
|
||||||
|
| Сервисов | 28 (25 LXC + 1 VM + 2 внешних) |
|
||||||
|
| SSO интеграция | 13/28 через Authentik |
|
||||||
|
| Автоматизация | 35% |
|
||||||
|
| Активных инцидентов | 0 |
|
||||||
|
| Последний спринт | Sprint 2 ✅ Завершён |
|
||||||
|
|
||||||
|
## 🚀 Достижения
|
||||||
|
|
||||||
|
- **Sprint 2 (2026-08-04):** Telegram-алертинг через DPI — Tailscale exit node, HTTPS-proxy для n8n, мониторинг 17 хостов. [ADR-005](docs/adr/ADR-005-tailscale-exit-node.md)
|
||||||
|
- **Sprint 1 (2026-08-03):** Authentik SSO — 13 сервисов через OIDC, прокси-порты 9984-9989. [ADR-004](docs/adr/ADR-004-authentik-proxy.md)
|
||||||
|
|
||||||
|
## 🗂️ Навигация
|
||||||
|
|
||||||
|
- 📖 [CONTEXT.md](CONTEXT.md) — **AI-агентам читать первым делом**
|
||||||
|
- 📋 [Реестр 28 сервисов](docs/SERVICES.md)
|
||||||
|
- 🎯 [Sprint 3 Plan](docs/SPRINT-3-PLAN.md)
|
||||||
|
- 🏗️ [Архитектура](docs/ARCHITECTURE.md)
|
||||||
|
- 🚨 [Инциденты](docs/INCIDENTS.md)
|
||||||
|
- 📚 [ADR (решения)](docs/adr/)
|
||||||
|
- 📘 [Runbooks (инструкции)](knowledge/runbooks/)
|
||||||
|
|
||||||
|
## 🔗 Доступ к ключевым сервисам
|
||||||
|
|
||||||
|
| Сервис | URL |
|
||||||
|
|--------|-----|
|
||||||
|
| n8n UI | http://192.168.1.108:5680 |
|
||||||
|
| n8n через SSO | http://192.168.1.108:5678 |
|
||||||
|
| Gitea | http://192.168.1.140:3000 |
|
||||||
|
| Authentik | http://192.168.1.114:9000 |
|
||||||
|
| Grafana | http://192.168.1.113:3000 |
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
services:
|
||||||
|
n8n:
|
||||||
|
image: docker.n8n.io/n8nio/n8n:latest
|
||||||
|
container_name: n8n
|
||||||
|
restart: unless-stopped
|
||||||
|
networks: [buryan-net]
|
||||||
|
dns: [8.8.8.8, 1.1.1.1]
|
||||||
|
ports: ["5680:5678"]
|
||||||
|
environment:
|
||||||
|
- N8N_SECURE_COOKIE=false
|
||||||
|
- GENERIC_TIMEZONE=Europe/Moscow
|
||||||
|
- TZ=Europe/Moscow
|
||||||
|
- WEBHOOK_URL=https://n8n.buryans.ru/
|
||||||
|
# ВАЖНО: gateway buryan-net, не LAN-IP! (ADR-005)
|
||||||
|
- HTTPS_PROXY=http://172.19.0.1:1055
|
||||||
|
- HTTP_PROXY=http://172.19.0.1:1055
|
||||||
|
- NO_PROXY=localhost,127.0.0.1,192.168.1.0/24,172.19.0.0/16,172.17.0.0/16
|
||||||
|
volumes:
|
||||||
|
- /path/to/n8n/data:/home/node/.n8n
|
||||||
|
|
||||||
|
networks:
|
||||||
|
buryan-net:
|
||||||
|
external: true
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
OAUTH2_PROXY_PROVIDER=oidc
|
||||||
|
OAUTH2_PROXY_OIDC_ISSUER_URL=http://192.168.1.114:9000/application/o/n8n-proxy/
|
||||||
|
OAUTH2_PROXY_CLIENT_ID=n8n-proxy
|
||||||
|
OAUTH2_PROXY_CLIENT_SECRET=CHANGE_ME
|
||||||
|
OAUTH2_PROXY_COOKIE_SECRET=CHANGE_ME_32_CHARS
|
||||||
|
OAUTH2_PROXY_COOKIE_SECURE=false
|
||||||
|
OAUTH2_PROXY_EMAIL_DOMAINS=*
|
||||||
|
OAUTH2_PROXY_REDIRECT_URL=http://192.168.1.108:5678/oauth2/callback
|
||||||
|
OAUTH2_PROXY_SKIP_PROVIDER_BUTTON=true
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
services:
|
||||||
|
oauth2-proxy-n8n:
|
||||||
|
image: quay.io/oauth2-proxy/oauth2-proxy:latest
|
||||||
|
container_name: oauth2-proxy-n8n
|
||||||
|
restart: unless-stopped
|
||||||
|
networks: [buryan-net]
|
||||||
|
ports: ["5678:5678"]
|
||||||
|
env_file: [.env]
|
||||||
|
environment:
|
||||||
|
- OAUTH2_PROXY_UPSTREAMS=http://n8n:5678
|
||||||
|
- OAUTH2_PROXY_HTTP_ADDRESS=0.0.0.0:5678
|
||||||
|
command:
|
||||||
|
- --skip-auth-regex=^/webhook
|
||||||
|
- --skip-auth-regex=^/healthz
|
||||||
|
- --skip-auth-regex=^/rest
|
||||||
|
|
||||||
|
networks:
|
||||||
|
buryan-net:
|
||||||
|
external: true
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
# 🏗️ Архитектура Buryan Hub
|
||||||
|
|
||||||
|
## Общая схема
|
||||||
|
|
||||||
|
┌──────────────────────────────────────────────┐
|
||||||
|
│ PROXMOX VE (192.168.1.10) │
|
||||||
|
│ 25 LXC + 1 VM: сервисы, мониторинг, медиа │
|
||||||
|
│ LXC 108: n8n + Node-RED + tailscaled │
|
||||||
|
│ LXC 114: Authentik (SSO) │
|
||||||
|
│ LXC 140: Gitea (SSoT) │
|
||||||
|
└──────────────────┬───────────────────────────┘
|
||||||
|
│ Tailscale tunnel
|
||||||
|
▼
|
||||||
|
┌──────────────────────┐
|
||||||
|
│ VPS 185.221.198.255 │ (exit node)
|
||||||
|
└──────────────────────┘
|
||||||
|
▼
|
||||||
|
api.telegram.org и др.
|
||||||
|
|
||||||
|
## Ключевые компоненты
|
||||||
|
|
||||||
|
- **Authentik (SSO):** LXC 114, OIDC, outpost-порты 9984-9989
|
||||||
|
- **n8n (автоматизация):** LXC 108, HTTPS_PROXY через gateway
|
||||||
|
- **Tailscale (VPN):** userspace-networking, HTTP proxy 1055
|
||||||
|
- **Gitea (SSoT):** LXC 140, ADR + runbooks + конфиги
|
||||||
|
|
||||||
|
## Сети
|
||||||
|
|
||||||
|
| Сеть | CIDR | Назначение |
|
||||||
|
|------|------|------------|
|
||||||
|
| LAN | 192.168.1.0/24 | Локальная сеть |
|
||||||
|
| buryan-net | 172.19.0.0/16 | Docker-сеть n8n + oauth2 |
|
||||||
|
| Tailscale | 100.x.x.x | VPN PVE ↔ VPS |
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
# 🚨 Трекер инцидентов
|
||||||
|
|
||||||
|
## Активные инциденты
|
||||||
|
*Нет активных инцидентов* ✅
|
||||||
|
|
||||||
|
## Решённые
|
||||||
|
|
||||||
|
| # | Дата | Сервис | Проблема | Решение | ADR |
|
||||||
|
|---|------|--------|----------|---------|-----|
|
||||||
|
| 1 | 2026-08-04 | Telegram | DPI-блокировка | Tailscale exit node | ADR-005 |
|
||||||
|
| 2 | 2026-08-04 | n8n | 502 Gateway | oauth2-proxy в buryan-net | Sprint 2 |
|
||||||
|
| 3 | 2026-08-04 | n8n | Алерты не шлются | Замена токена credential | — |
|
||||||
|
| 4 | 2026-07-06 | Tailscale | TUN not found | LXC override | ADR-002 |
|
||||||
|
| 5 | 2026-07-06 | OpenClaw | missing gateway.mode | Конфиг | ADR-003 |
|
||||||
|
|
||||||
|
## Шаблон нового инцидента
|
||||||
|
|
||||||
|
### INCIDENT-NNN: [Краткое описание]
|
||||||
|
**Дата:** YYYY-MM-DD | **Статус:** Active | **Критичность:** High
|
||||||
|
#### Описание / Влияние / Диагностика / Решение / Профилактика
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
# 📋 Реестр сервисов
|
||||||
|
|
||||||
|
Обновлено: 2026-08-05
|
||||||
|
|
||||||
|
## Легенда
|
||||||
|
|
||||||
|
- 🟢 Готово — работает, SSO настроен
|
||||||
|
- 🟡 Работает, но SSO не настроен
|
||||||
|
- 🔴 Требует настройки
|
||||||
|
- ⚪ Без SSO (basic auth)
|
||||||
|
|
||||||
|
## Сервисы (28)
|
||||||
|
|
||||||
|
| # | Сервис | LXC/VM | Порт | Прокси-порт | Статус | Runbook |
|
||||||
|
|---|--------|--------|------|-------------|--------|---------|
|
||||||
|
| 1 | Grafana | 113 | 3000 | 3000 | 🟢 | [rb](../knowledge/runbooks/grafana.md) |
|
||||||
|
| 2 | Gitea | 140 | 3000 | 3000 | 🟢 | [rb](../knowledge/runbooks/gitea.md) |
|
||||||
|
| 3 | n8n | 108 | 5678/5680 | 5678 | 🟢 | [rb](../knowledge/runbooks/n8n.md) |
|
||||||
|
| 4 | Node-RED | 108 | 1880 | 1880 | 🟢 | [rb](../knowledge/runbooks/nodered.md) |
|
||||||
|
| 5 | FreshRSS | 111 | 8080 | 8080 | 🟢 | [rb](../knowledge/runbooks/freshrss.md) |
|
||||||
|
| 6 | Vaultwarden | 109 | 8000 | 8000 | 🟢 | [rb](../knowledge/runbooks/vaultwarden.md) |
|
||||||
|
| 7 | Jellyfin | 103 | 8096 | 8096 | 🟢 | [rb](../knowledge/runbooks/jellyfin.md) |
|
||||||
|
| 8 | Sonarr | 117 | 8989 | 9989 | 🟢 | [rb](../knowledge/runbooks/sonarr.md) |
|
||||||
|
| 9 | Radarr | 118 | 7878 | 9988 | 🟢 | [rb](../knowledge/runbooks/radarr.md) |
|
||||||
|
| 10 | Prowlarr | 119 | 9696 | 9987 | 🟢 | [rb](../knowledge/runbooks/prowlarr.md) |
|
||||||
|
| 11 | Bazarr | 120 | 6767 | 9986 | 🟢 | [rb](../knowledge/runbooks/bazarr.md) |
|
||||||
|
| 12 | Overseerr | 121 | 5055 | 9985 | 🟢 | [rb](../knowledge/runbooks/overseerr.md) |
|
||||||
|
| 13 | Tautulli | 122 | 8181 | 9984 | 🟢 | [rb](../knowledge/runbooks/tautulli.md) |
|
||||||
|
| 14 | Linkding | 127 | 3000 | 9091 | 🟡 | [rb](../knowledge/runbooks/linkding.md) |
|
||||||
|
| 15 | Dashy | 102 | 8080 | 9983 | 🔴 | [rb](../knowledge/runbooks/dashy.md) |
|
||||||
|
| 16 | Nextcloud | 105 | 80/443 | 9982 | 🔴 | [rb](../knowledge/runbooks/nextcloud.md) |
|
||||||
|
| 17 | Paperless | 110 | 8000 | 9981 | 🔴 | [rb](../knowledge/runbooks/paperless.md) |
|
||||||
|
| 18 | Calibre-web | 111 | 8083 | 9980 | 🔴 | [rb](../knowledge/runbooks/calibre.md) |
|
||||||
|
| 19 | Home Assistant | 106 | 8123 | 9979 | 🔴 | [rb](../knowledge/runbooks/homeassistant.md) |
|
||||||
|
| 20 | Immich | 104 (VM) | 2283 | 9978 | 🔴 | [rb](../knowledge/runbooks/immich.md) |
|
||||||
|
| 21 | Plex | 116 | 32400 | 9977 | 🔴 | [rb](../knowledge/runbooks/plex.md) |
|
||||||
|
| 22 | Navidrome | 125 | 4533 | 9976 | 🔴 | [rb](../knowledge/runbooks/navidrome.md) |
|
||||||
|
| 23 | OpenClaw | 115 | 18789 | 9975 | 🔴 | [rb](../knowledge/runbooks/openclaw.md) |
|
||||||
|
| 24 | Matrix | 155 | 8008 | 9974 | 🔴 | [rb](../knowledge/runbooks/matrix.md) |
|
||||||
|
| 25 | Syncthing | 139 | 8384 | — | ⚪ | [rb](../knowledge/runbooks/syncthing.md) |
|
||||||
|
| 26 | Prometheus | 134 | 9090 | — | ⚪ | [rb](../knowledge/runbooks/prometheus.md) |
|
||||||
|
| 27 | Uptime Kuma | 107 | 3001 | — | ⚪ | [rb](../knowledge/runbooks/uptimekuma.md) |
|
||||||
|
| 28 | AdGuard | 107 | 53/80 | — | ⚪ | [rb](../knowledge/runbooks/adguard.md) |
|
||||||
|
|
||||||
|
## Сводка
|
||||||
|
|
||||||
|
🟢 13 | 🟡 1 | 🔴 10 | ⚪ 4
|
||||||
|
|
||||||
|
## Следующие шаги
|
||||||
|
|
||||||
|
1. Настроить SSO для 10 сервисов со статусом 🔴
|
||||||
|
2. Доделать Linkding (🟡)
|
||||||
|
3. Заполнить runbooks-заглушки
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
# 🎯 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)
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
# 🎯 Sprint 3 Plan: Умные алерты
|
||||||
|
|
||||||
|
**Статус:** Планируется | **Старт:** 2026-08-06 | **Оценка:** ~15 часов
|
||||||
|
|
||||||
|
## Задачи
|
||||||
|
|
||||||
|
### 1. Дедупликация алертов (4ч)
|
||||||
|
Проблема: хост с failed=1 шлёт алерт каждый цикл отчёта.
|
||||||
|
Решение: хранить состояние хоста, алерт только при изменении (0→1, 1→0).
|
||||||
|
|
||||||
|
### 2. Rate limiting (3ч)
|
||||||
|
Проблема: 10 упавших хостов = 10 алертов подряд.
|
||||||
|
Решение: сводный алерт раз в 15 минут.
|
||||||
|
|
||||||
|
### 3. Алерт "всё восстановилось" (2ч)
|
||||||
|
Отслеживать переход failed=1 → failed=0, слать "✅ восстановлено".
|
||||||
|
|
||||||
|
### 4. Grafana дашборд (4ч)
|
||||||
|
Визуализация состояния всех хостов (Prometheus + Grafana).
|
||||||
|
|
||||||
|
### 5. Runbook диагностики алертов (2ч)
|
||||||
|
Чеклист "алерт не пришёл" — проверка по слоям.
|
||||||
|
|
||||||
|
## Success criteria
|
||||||
|
- [ ] ≤ 5 алертов/час на всю инфраструктуру
|
||||||
|
- [ ] Алерт при изменении состояния, не каждый цикл
|
||||||
|
- [ ] Сводные алерты при массовых сбоях
|
||||||
|
- [ ] Подтверждение восстановления
|
||||||
|
- [ ] Работающий Grafana-дашборд
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
# ADR-001: Локальный NPM вместо прямого VPS
|
||||||
|
|
||||||
|
**Статус:** Принят | **Дата:** 2026-07-06
|
||||||
|
|
||||||
|
## Контекст
|
||||||
|
VPS не видит локальные IP; отладка Tailscale = 1-2 часа. Нужен быстрый доступ по доменам.
|
||||||
|
|
||||||
|
## Решение
|
||||||
|
Локальный NPM (LXC 101) для LAN; VPS NPM — только для внешнего доступа.
|
||||||
|
|
||||||
|
## Последствия
|
||||||
|
- ✅ Быстрый старт (15 минут)
|
||||||
|
- ⚠️ Дублирование конфигурации NPM
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# ADR-002: TUN device для Tailscale в LXC
|
||||||
|
|
||||||
|
**Статус:** Принят | **Дата:** 2026-07-06
|
||||||
|
|
||||||
|
## Контекст
|
||||||
|
Tailscale в LXC: "tun module not loaded nor found on disk".
|
||||||
|
|
||||||
|
## Решение
|
||||||
|
Добавить в конфиг LXC:
|
||||||
|
|
||||||
|
lxc.cgroup2.devices.allow: c 10:200 rwm
|
||||||
|
lxc.mount.entry: /dev/net/tun dev/net/tun none bind,create=file
|
||||||
|
|
||||||
|
## Последствия
|
||||||
|
- ✅ Полнофункциональный Tailscale в LXC
|
||||||
|
- ⚠️ Нужен root-доступ к PVE для правки конфига
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# ADR-003: OpenClaw gateway.mode
|
||||||
|
|
||||||
|
**Статус:** Принят | **Дата:** 2026-07-06
|
||||||
|
|
||||||
|
## Контекст
|
||||||
|
OpenClaw v2026.6.11: "Gateway start blocked: existing config is missing gateway.mode".
|
||||||
|
|
||||||
|
## Решение
|
||||||
|
Добавить в /opt/openclaw/openclaw.json:
|
||||||
|
|
||||||
|
{ "gateway": { "mode": "local",
|
||||||
|
"auth": { "mode": "token", "token": "<token>" },
|
||||||
|
"trustedProxies": ["192.168.1.10"] } }
|
||||||
|
|
||||||
|
## Риски
|
||||||
|
- Токен в открытом виде → перенести в secrets (TODO)
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
# ADR-004: Authentik Outpost с прокси-портами
|
||||||
|
|
||||||
|
**Статус:** Принят | **Дата:** 2026-08-03
|
||||||
|
|
||||||
|
## Контекст
|
||||||
|
Ручная настройка SSO для 28 сервисов = 14-28 часов.
|
||||||
|
|
||||||
|
## Решение
|
||||||
|
Authentik Outpost с прокси-портами 9984-9989 + автоматизация через API + YAML.
|
||||||
|
|
||||||
|
## Результат
|
||||||
|
13 сервисов за 2 часа (экономия ~11 часов).
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
# ADR-005: Обход DPI через Tailscale exit node + outbound HTTP proxy
|
||||||
|
|
||||||
|
**Статус:** Принят | **Дата:** 2026-08-04 | **Автор:** Roman + Qwen
|
||||||
|
|
||||||
|
## Контекст
|
||||||
|
Провайдер (DPI) блокирует api.telegram.org. n8n обязан слать алерты надёжно.
|
||||||
|
|
||||||
|
## Решение
|
||||||
|
LXC 108: tailscaled в userspace-networking + outbound HTTP proxy :1055.
|
||||||
|
n8n: HTTPS_PROXY=http://172.19.0.1:1055 (gateway сети buryan-net, НЕ LAN-IP!).
|
||||||
|
|
||||||
|
systemd override:
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
ExecStart=
|
||||||
|
ExecStart=/usr/sbin/tailscaled -tun=userspace-networking \
|
||||||
|
-outbound-http-proxy-listen=0.0.0.0:1055 \
|
||||||
|
-state=/var/lib/tailscale/tailscaled.state
|
||||||
|
|
||||||
|
n8n env:
|
||||||
|
|
||||||
|
HTTPS_PROXY=http://172.19.0.1:1055
|
||||||
|
HTTP_PROXY=http://172.19.0.1:1055
|
||||||
|
NO_PROXY=localhost,127.0.0.1,192.168.1.0/24,172.19.0.0/16,172.17.0.0/16
|
||||||
|
|
||||||
|
## Альтернативы
|
||||||
|
| Вариант | Почему отвергнут |
|
||||||
|
|---------|------------------|
|
||||||
|
| Прямое соединение | DPI блокирует |
|
||||||
|
| SOCKS5 | n8n не поддерживает из коробки |
|
||||||
|
| Другой мессенджер | Переписывание агентов |
|
||||||
|
|
||||||
|
## Последствия
|
||||||
|
- ✅ Telegram доступен из Docker
|
||||||
|
- ⚠️ Docker не видит LAN-IP хоста — только gateway сети
|
||||||
|
- ⚠️ Зависимость от VDS
|
||||||
|
|
||||||
|
## Мониторинг
|
||||||
|
curl -s -x http://172.19.0.1:1055 https://api.telegram.org/bot<TOKEN>/getMe
|
||||||
|
docker exec n8n env | grep -i proxy
|
||||||
|
journalctl -u tailscaled -n 50
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
# ADR-NNN: [Название решения]
|
||||||
|
|
||||||
|
**Статус:** [Proposed | Accepted | Deprecated]
|
||||||
|
**Дата:** YYYY-MM-DD
|
||||||
|
**Автор:** [Roman / Qwen]
|
||||||
|
|
||||||
|
## Контекст
|
||||||
|
[Почему возникла проблема?]
|
||||||
|
|
||||||
|
## Решение
|
||||||
|
[Что сделали?]
|
||||||
|
|
||||||
|
## Альтернативы
|
||||||
|
| Вариант | Почему отвергнут |
|
||||||
|
|---------|------------------|
|
||||||
|
|
||||||
|
## Последствия
|
||||||
|
### Положительные / Отрицательные / Риски
|
||||||
|
|
||||||
|
## Связанные документы
|
||||||
Executable
+8
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# Использование: ./harness/update-context.sh "Описание задачи"
|
||||||
|
TASK="$1"
|
||||||
|
[ -z "$TASK" ] && { echo "Использование: $0 \"описание\""; exit 1; }
|
||||||
|
cd "$(dirname "$0")/.."
|
||||||
|
git add -A
|
||||||
|
git commit -m "Agent update: $TASK" || exit 0
|
||||||
|
echo "✅ Контекст обновлён: $TASK"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# adguard Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
# Authentik Runbook (LXC 114)
|
||||||
|
|
||||||
|
**Статус интеграции:** 13/28 сервисов
|
||||||
|
|
||||||
|
## Проверка
|
||||||
|
docker ps | grep authentik
|
||||||
|
docker logs --tail 20 authentik-server
|
||||||
|
curl -s http://192.168.1.114:9000/api/v3/core/applications/ | head -50
|
||||||
|
|
||||||
|
## Частые проблемы
|
||||||
|
| Проблема | Решение |
|
||||||
|
|----------|---------|
|
||||||
|
| origin not allowed | Добавить домен в allowedOrigins |
|
||||||
|
| redirect_uri mismatch | Сверить конфиг сервиса и провайдера |
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# bazarr Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# calibre Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# dashy Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# freshrss Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
# Gitea Runbook (LXC 140)
|
||||||
|
|
||||||
|
**URL:** http://192.168.1.140:3000
|
||||||
|
|
||||||
|
## Проверка
|
||||||
|
curl -s -o /dev/null -w "%{http_code}\n" http://192.168.1.140:3000/
|
||||||
|
curl -s "http://192.168.1.140:3000/api/v1/repos/search?limit=50"
|
||||||
|
|
||||||
|
## Создание репо через API
|
||||||
|
curl -u root:PASS -X POST http://192.168.1.140:3000/api/v1/user/repos \
|
||||||
|
-H "Content-Type: application/json" -d '{"name":"repo","private":false}'
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# grafana Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# homeassistant Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# immich Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# jellyfin Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# linkding Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# matrix Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
# n8n Runbook (LXC 108)
|
||||||
|
|
||||||
|
**Workflow ID:** afdmDW35vpDd6oNs (Buryan Health Monitor)
|
||||||
|
|
||||||
|
## Проверка
|
||||||
|
docker ps | grep n8n
|
||||||
|
docker logs --tail 50 n8n
|
||||||
|
docker exec n8n env | grep -iE "proxy|secure"
|
||||||
|
|
||||||
|
## Частые проблемы
|
||||||
|
| Проблема | Решение |
|
||||||
|
|----------|---------|
|
||||||
|
| 404 webhook not registered | n8n publish:workflow --id=<ID> |
|
||||||
|
| connection timed out | Проверить HTTPS_PROXY=http://172.19.0.1:1055 |
|
||||||
|
| Authorization failed | Обновить токен в credential Telegram |
|
||||||
|
| secure cookie ошибка | -e N8N_SECURE_COOKIE=false |
|
||||||
|
|
||||||
|
## Управление workflow
|
||||||
|
docker exec n8n n8n list:workflow
|
||||||
|
docker exec n8n n8n publish:workflow --id=afdmDW35vpDd6oNs
|
||||||
|
docker exec n8n n8n export:workflow --id=<ID>
|
||||||
|
docker exec n8n n8n import:workflow --input=/tmp/wf.json
|
||||||
|
|
||||||
|
## Тест webhook
|
||||||
|
curl -X POST http://192.168.1.108:5678/webhook/buryan-health \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"host":"TEST","failed":1,"restarted":0,"mem":50,"disk":60,"containers":[]}'
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# navidrome Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# nextcloud Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# nodered Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
# OAuth2-proxy Runbook (LXC 108)
|
||||||
|
|
||||||
|
**Контейнер:** oauth2-proxy-n8n | **Порт:** 5678 | **Upstream:** http://n8n:5678
|
||||||
|
|
||||||
|
## Проверка
|
||||||
|
docker ps | grep oauth2-proxy
|
||||||
|
docker logs --tail 20 oauth2-proxy-n8n
|
||||||
|
curl -s -o /dev/null -w "%{http_code}\n" http://192.168.1.108:5678/
|
||||||
|
|
||||||
|
## Пропуск без авторизации
|
||||||
|
^/webhook, ^/healthz, ^/rest
|
||||||
|
|
||||||
|
## Пересоздание
|
||||||
|
cd /root/buryan-infra/docker/oauth2-proxy && docker compose up -d
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# openclaw Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# overseerr Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# paperless Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# plex Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# prometheus Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# prowlarr Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# radarr Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# sonarr Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# syncthing Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
# Tailscale Runbook (LXC 108)
|
||||||
|
|
||||||
|
**Критичность:** 🔴 Высокая
|
||||||
|
|
||||||
|
## Проверка статуса
|
||||||
|
systemctl status tailscaled
|
||||||
|
journalctl -u tailscaled -n 50
|
||||||
|
curl -s -x http://172.19.0.1:1055 https://api.telegram.org/bot<TOKEN>/getMe
|
||||||
|
|
||||||
|
## Частые проблемы
|
||||||
|
| Проблема | Решение |
|
||||||
|
|----------|---------|
|
||||||
|
| Connection timed out | Рестарт tailscaled, проверить VDS |
|
||||||
|
| Прокси недоступен из Docker | Использовать 172.19.0.1, не 192.168.1.108 |
|
||||||
|
|
||||||
|
## Восстановление
|
||||||
|
sudo systemctl restart tailscaled
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# tautulli Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# uptimekuma Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# vaultwarden Runbook
|
||||||
|
|
||||||
|
**Статус:** Требуется документирование
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- [ ] Процедура проверки статуса
|
||||||
|
- [ ] Частые проблемы и решения
|
||||||
|
- [ ] Команды восстановления
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# /etc/systemd/system/tailscaled.service.d/override.conf
|
||||||
|
# Применение:
|
||||||
|
# sudo mkdir -p /etc/systemd/system/tailscaled.service.d
|
||||||
|
# sudo cp override.conf туда; sudo systemctl daemon-reload
|
||||||
|
# sudo systemctl restart tailscaled
|
||||||
|
[Service]
|
||||||
|
ExecStart=
|
||||||
|
ExecStart=/usr/sbin/tailscaled -tun=userspace-networking -outbound-http-proxy-listen=0.0.0.0:1055 -state=/var/lib/tailscale/tailscaled.state
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# n8n Workflows
|
||||||
|
|
||||||
|
Экспорты workflow для версионирования в Git.
|
||||||
|
|
||||||
|
## Импорт
|
||||||
|
docker cp workflows/buryan-health-monitor.json n8n:/tmp/wf.json
|
||||||
|
docker exec n8n n8n import:workflow --input=/tmp/wf.json
|
||||||
|
docker exec n8n n8n publish:workflow --id=<ID>
|
||||||
Reference in new issue
Block a user