Files
buryan-infra/docs/plan/FINISH-LINE.md

161 lines
12 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.
# Финишная подготовка Buryan Hub перед локальной LLM (28.10.2026)
Аудит проведён по фактам: 33 LXC + VM, 43 сервиса в реестре, 61 монитор Kuma,
36 таргетов Prometheus, 20 systemd-таймеров, 42 файла в `/etc/cron.d`,
740 коммитов в SSOT-репозитории.
---
## 1. Уровень зрелости по направлениям
| Направление | Оценка | Обоснование (проверено) |
|---|---|---|
| **Резервное копирование** | ★★★★★ | 3-2-1: HDD (дампы+конфиги+базы), restic offsite на VPS (113 снимков, 80.9 ГБ), Kuma-heartbeat по свежести, ежемесячный restore-тест 5/5 |
| **Мониторинг** | ★★★★☆ | Prometheus 36 таргетов/0 down, Grafana, Loki, Alertmanager, Kuma 61 монитор/0 down. Минус: проверка обновлений не работает |
| **SSO и доступы** | ★★★★☆ | Authentik, 52 приложения, группы семьи. Минус: 2FA не включён, Vaultwarden пуст |
| **Медиа** | ★★★★★ | Prowlarr → Radarr/Sonarr → qBittorrent → импорт → Jellyfin, профили качества, 50 ГБ медиатеки на NVMe, аудиокниги, книги, музыка |
| **Дом** | ★★★☆☆ | HA + Zigbee2MQTT + Frigate, автоматизации есть. Минус: часть устройств не подключена (реле, Xiaomi/Tuya) |
| **Данные и хранилище** | ★★★★★ | Общее хранилище 938 ГБ (11 сервисов), архив на HDD, btrfs? нет — ext4, осознанно |
| **Автоматизации (боты/рой)** | ★★★☆☆ | 11 ботов, таймеры, самовосстановление. Минус: 60+ разрозненных заданий без единого реестра |
| **Безопасность хоста** | ★★☆☆☆ | **fail2ban не работает**, `PermitRootLogin yes`, секреты файлами в `/root` |
| **Инженерные практики** | ★★★☆☆ | Git-SSOT 740 коммитов, ранбуки. Минус: нет CI, нет staging |
---
## 2. Найдено сегодня и требует решения
### P0 — безопасность (сделать до локальной LLM)
| # | Проблема | Факт | Риск |
|---|---|---|---|
| 1 | **fail2ban не установлен/не работает** | `systemctl is-active fail2ban` → inactive | перебор паролей SSH/веб без ограничений |
| 2 | **Вход root по паролю разрешён** | `PermitRootLogin yes` | брутфорс на 22 порт |
| 3 | **2FA не включён** | стадия TOTP есть (`default-authenticator-totp-setup`), у владельца устройства нет | одна утечка пароля = полный доступ |
| 4 | **Vaultwarden пуст** | `/data` = 300 КБ, только `db.sqlite3` | секреты в `/root/.*` незашифрованы |
| 5 | Immich ML выключен | `immich_machine_learning Exited (143) 6 days ago` | нет распознавания лиц/поиска по фото |
### P1 — надёжность
| # | Проблема | Факт |
|---|---|---|
| 6 | **Проверка обновлений сломана** | `check_updates.py` → «проверено: 0», exit 1 |
| 7 | **Immich VM в бэкапе раз в неделю** | weekly job `vmid 104,115,160` — RPO 7 дней для фото |
| 8 | **Loki без политики хранения** | конфиг без `retention`, data растёт (269 МБ и вверх) |
| 9 | Нет внешнего synthetic-мониторинга | Kuma внутри сети; снаружи проверяется только VPS TCP 443 |
| 10 | Нет CI в Gitea | Actions не настроены (0 файлов) |
### P2 — порядок и актуальность
| # | Что | Действие |
|---|---|---|
| 11 | **CT116 Plex** — работает только beszel/promtail, Plex не запущен, память 4 ГБ | остановить и удалить или вернуть в строй осознанно |
| 12 | **CT122 Tautulli** — бесполезен без Plex (303) | заменить на Jellystat для статистики Jellyfin |
| 13 | **42 файла `/etc/cron.d`** + 20 таймеров | свести в реестр, убрать остатки `.bak` |
| 14 | 104 документа в `docs/`, 423 в `ops/` (84 МБ) | ввести индекс и правило «один документ на тему» |
| 15 | Секреты файлами в `/root` | перенести в Vaultwarden, файлы оставить как аварийный путь |
---
## 3. Порядок в автоматизациях (предложение)
Сейчас задания размазаны по четырём местам: `crontab`, `/etc/cron.d` (42 файла),
systemd-таймеры (~20), встроенные циклы ботов. Ни один список не является полным.
**Что предлагаю:**
1. **Единый реестр** `ops/automations/registry.yaml` — для каждого задания:
имя, расписание, что делает, владелец, что делать при падении, как проверить.
2. **Нормализация имён**: `hub-<домен>-<действие>` (например `hub-media-cleanup`,
`hub-backup-configs`), без разнобоя `backup.sh` / `check-services.sh` / `swarm-watchdog.sh`.
3. **Окна по домену**: бэкапы 01:00–05:00, чистки 05:00–06:00, отчёты 07:00–09:00,
мониторинг — постоянно. Это уже почти так, надо зафиксировать в реестре.
4. **Dead man switch**: если задание не запускалось дольше 2× интервала —
алерт в Kuma/Prometheus. Сейчас такое есть только у бэкапов (heartbeat).
5. **Один лог**: `journalctl` для systemd + `/var/log/hub/<задача>.log` для cron,
с ротацией; сейчас логи в трёх разных местах.
6. **Удалить дубли**: `buryan-cleanup` и `hub-dl-cleanup` (проверить, что не одно и то же),
`buryan-monitor` и `buryan-monitoring`.
---
## 4. Что стоит добавить (мои рекомендации)
| Приоритет | Что | Зачем |
|---|---|---|
| **P0** | fail2ban + `PermitRootLogin prohibit-password` | закрыть брутфорс |
| **P0** | 2FA в Authentik + принудительная политика для владельца | реальная защита входа |
| **P0** | Заполнить Vaultwarden, перенести секреты | единое хранилище, автозаполнение, отзыв |
| **P1** | Дублировать бэкап Immich ежедневно (место есть) | RPO 7 дней → 1 день |
| **P1** | Починить `check_updates.py` и вывести «есть обновления» в Grafana | не пропускать уязвимости |
| **P1** | Retention в Loki (30 дней) | контролируемый рост |
| **P1** | Blackbox exporter на VPS: внешние проверки 5 ключевых URL | видеть отказ, когда лежит и сеть, и сервер |
| **P2** | Jellystat вместо Tautulli | статистика просмотров Jellyfin |
| **P2** | Gitea Actions: линт YAML/compose и проверка «все контейнеры поднялись» | CI без внешних сервисов |
| **P2** | Ежемесячный отчёт «инвентаризация»: что изменилось, что устарело | порядок без ручной работы |
| **P3** | Голосовой ассистент (V-01…V-08) | после локальной LLM |
---
## 5. MCore 4 Pro (NonOS): что нужно от владельца
### Шаг 1. Железо (30 минут)
- [ ] Второй модуль памяти DDR5 SODIMM: **16 ГБ** (будет 32 ГБ) — обязательно для моделей 14B.
Больше 64 ГБ не нужно: платформа Ultra 5 125H ограничена.
- [ ] Кабель Ethernet в свободный порт коммутатора.
- [ ] Резерв IP в роутере: предлагаю **192.168.1.30**, имя `mc-ai`.
- [ ] USB-флешка ≥ 8 ГБ для установщика.
### Шаг 2. BIOS (10 минут)
- [ ] Вход в BIOS (Del/F2 при старте).
- [ ] Включить **VT-x** и **VT-d** (виртуализация) — понадобится, если захотим пробросить iGPU.
- [ ] **Above 4G Decoding** — включить.
- [ ] Boot: USB первым, Secure Boot можно оставить включённым (Proxmox подписан).
- [ ] Сохранить и выйти.
### Шаг 3. Установка (30 минут, делаете вы или я по вашей команде с консоли)
Рекомендую **Proxmox VE 9** (как на основном сервере): снапшоты, LXC, единый подход.
Альтернатива — Debian 12 + Docker (легче, но без снапшотов).
- [ ] Скачать ISO: `proxmox.com/en/downloads` → Proxmox VE 9 ISO.
- [ ] Записать на флешку (Rufus / balenaEtcher).
- [ ] Установить: hostname `mc-ai`, IP `192.168.1.30/24`, шлюз `192.168.1.1`, DNS `192.168.1.1`.
- [ ] После установки зайти на `https://192.168.1.30:8006`.
### Шаг 4. Что сделаю я после установки
1. Обновление системы, базовые пакеты, `qemu-guest-agent`.
2. Подключение к Tailscale (`tailscale up`), чтобы был доступ извне.
3. NFS-клиент к `/mnt/media/models` с основного сервера — модели не дублируются.
4. Установка Ollama + `open-webui` (или LXC с Docker).
5. Загрузка моделей: `qwen2.5:7b` (секретари), `qwen2.5:14b` (работа), `bge-m3` (RAG), `whisper` (транскрипция).
6. Регистрация в мониторинге (Kuma + Prometheus + node_exporter).
7. Бэкап конфигурации в общий контур (vzdump на HDD).
8. Перевод ботов-секретарей на локальный роутер намерений (с откатом на облако).
### Шаг 5. Проверка (после, 15 минут)
- [ ] `curl http://192.168.1.30:11434/api/tags` — список моделей.
- [ ] Тест скорости: 7B на iGPU vs CPU.
- [ ] Ответ секретаря в Matrix без обращения к облаку.
- [ ] Мониторы Kuma зелёные, алертов 0.
---
## 6. Порядок работ (предлагаю)
| Этап | Что | Время | Кто |
|---|---|---|---|
| 1 | Безопасность: fail2ban, запрет root-пароля, 2FA, Vaultwarden | 3–4 ч | я + вы (2FA-скан) |
| 2 | Надёжность: Immich ежедневно, check_updates, Loki retention, blackbox на VPS | 3 ч | я |
| 3 | Порядок: реестр автоматизаций, чистка CT116/122, индекс документов | 4 ч | я |
| 4 | MCore: железо + BIOS + установка | 1–2 ч | вы |
| 5 | MCore: Ollama, модели, интеграция с ботами | 3 ч | я |
| 6 | Jellystat, Gitea Actions, голос (по желанию) | по спросу | я |
**Итог:** проект уже на уровне «крепкий домашний прод». До «крутого» не хватает
трёх вещей: **безопасности (P0)**, **единого реестра автоматизаций** и
**локальной LLM**. Первые две делаются без железа — можно начать сразу.