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:
Roman committed 2026-08-05 12:14:25 +03:00
commit 0e7c26d00b
51 files changed
+766

No files matched your search

+9
View File
@@ -0,0 +1,9 @@
.env
*.sqlite*
*.db
crash.journal
n8nEventLog*
*.log
node_modules/
__pycache__/
.DS_Store
+55
View File
@@ -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)
+38
View File
@@ -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 |
+23
View File
@@ -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
+9
View File
@@ -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
+19
View File
@@ -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
+33
View File
@@ -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 |
+20
View File
@@ -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
#### Описание / Влияние / Диагностика / Решение / Профилактика
+53
View File
@@ -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-заглушки
+45
View File
@@ -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)
+29
View File
@@ -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-дашборд
+13
View File
@@ -0,0 +1,13 @@
# ADR-001: Локальный NPM вместо прямого VPS
**Статус:** Принят | **Дата:** 2026-07-06
## Контекст
VPS не видит локальные IP; отладка Tailscale = 1-2 часа. Нужен быстрый доступ по доменам.
## Решение
Локальный NPM (LXC 101) для LAN; VPS NPM — только для внешнего доступа.
## Последствия
- ✅ Быстрый старт (15 минут)
- ⚠️ Дублирование конфигурации NPM
+16
View File
@@ -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 для правки конфига
+16
View File
@@ -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)
+12
View File
@@ -0,0 +1,12 @@
# ADR-004: Authentik Outpost с прокси-портами
**Статус:** Принят | **Дата:** 2026-08-03
## Контекст
Ручная настройка SSO для 28 сервисов = 14-28 часов.
## Решение
Authentik Outpost с прокси-портами 9984-9989 + автоматизация через API + YAML.
## Результат
13 сервисов за 2 часа (экономия ~11 часов).
+41
View File
@@ -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
+20
View File
@@ -0,0 +1,20 @@
# ADR-NNN: [Название решения]
**Статус:** [Proposed | Accepted | Deprecated]
**Дата:** YYYY-MM-DD
**Автор:** [Roman / Qwen]
## Контекст
[Почему возникла проблема?]
## Решение
[Что сделали?]
## Альтернативы
| Вариант | Почему отвергнут |
|---------|------------------|
## Последствия
### Положительные / Отрицательные / Риски
## Связанные документы
+8
View File
@@ -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"
+8
View File
@@ -0,0 +1,8 @@
# adguard Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+14
View File
@@ -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 | Сверить конфиг сервиса и провайдера |
+8
View File
@@ -0,0 +1,8 @@
# bazarr Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# calibre Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# dashy Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# freshrss Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+11
View File
@@ -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}'
+8
View File
@@ -0,0 +1,8 @@
# grafana Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# homeassistant Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# immich Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# jellyfin Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# linkding Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# matrix Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+27
View File
@@ -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":[]}'
+8
View File
@@ -0,0 +1,8 @@
# navidrome Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# nextcloud Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# nodered Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+14
View File
@@ -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
+8
View File
@@ -0,0 +1,8 @@
# openclaw Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# overseerr Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# paperless Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# plex Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# prometheus Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# prowlarr Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# radarr Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# sonarr Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# syncthing Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+17
View File
@@ -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
+8
View File
@@ -0,0 +1,8 @@
# tautulli Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# uptimekuma Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -0,0 +1,8 @@
# vaultwarden Runbook
**Статус:** Требуется документирование
## TODO
- [ ] Процедура проверки статуса
- [ ] Частые проблемы и решения
- [ ] Команды восстановления
+8
View File
@@ -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
+8
View File
@@ -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>