Files
buryan-infra/docs/INTEGRATIONS-2026-10-19.md
T
buryan-agent 794adc438b Seerr вместо Overseerr + метрики медиасервисов и правила оповещений
Seerr (преемник Overseerr и Jellyseerr): поднят на CT 121, настроен на
Jellyfin, подключены Sonarr и Radarr, домен ombi переведён. Старый
Overseerr удалён.

Тонкости, на которые потратил время: настройки медиасервера требуют уже
открытой сессии (правится только через settings.json), первый вход требует
serverType в теле, Sonarr/Radarr ждут обязательные поля профиля.

Мониторинг: 4 экспортёра exportarr (Sonarr/Radarr/Prowlarr/Bazarr) в
Prometheus, адреса целей — на узел, а не 127.0.0.1 (Prometheus в контейнере).
Добавлены 3 правила: ошибка сбора, очередь, место. Всего 10 правил.

Карта интеграций и план по волнам — docs/INTEGRATIONS-2026-10-19.md.
2026-10-19 15:19:59 +03:00

139 lines
8.8 KiB
Markdown
Raw 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.
# Seerr и карта интеграций (19.10.2026)
Два блока: что заменено (Seerr вместо Overseerr) и полная карта интеграций
с планом до «высокого класса».
---
# Часть 1. Seerr вместо Overseerr
Overseerr объявлен устаревшим, проекты Overseerr и Jellyseerr объединились
в [Seerr](https://docs.seerr.dev/). Замену сделал, старый контейнер удалён.
| Что | Значение |
|---|---|
| Образ | `ghcr.io/seerr-team/seerr:latest` (CT 121, порт 5055) |
| Каталог | `/opt/seerr` (данные `/opt/seerr/config`) |
| Домен | `ombi.buryans.ru` (и `requests` → редирект) |
| Администратор | `akadmin` (через Jellyfin) |
| Медиасервер | Jellyfin `192.168.1.103:8096`, внешний `media.buryans.ru` |
| Sonarr / Radarr | подключены, тест связи — 200 |
## Про вход в Seerr — важная честность
У Seerr **нет OIDC**: методы входа — аккаунт медиасервера (Jellyfin/Plex)
или локальный пароль. Цепочка «Authentik → Jellyfin → Seerr» не работает
автоматически: Seerr проверяет **пароль** Jellyfin, а не сессию.
Что сделано: для `akadmin` задан пароль Jellyfin (файл
`/root/.jellyfin-akadmin-password`), он же — вход в Seerr.
Что можно улучшить (нужно ваше решение):
| Вариант | Как выглядит для человека |
|---|---|
| **Быстрое подключение Jellyfin** (Quick Connect) | нажимает «Войти через Jellyfin» → вводит код в уже открытом Jellyfin → вход без пароля |
| Пароли Jellyfin всем | один пароль на Jellyfin и Seerr, выдаётся таблицей |
| Локальные пароли Seerr | отдельный пароль только для Seerr |
Рекомендую первый: Jellyfin уже с SSO, и код вводится в приложении, где
человек уже авторизован.
---
# Часть 2. Что уже интегрировано
## Инфраструктура
| Слой | Что есть |
|---|---|
| Вход | Authentik (35 приложений), единый вход на 18 службах |
| Сеть | nginx на доме и на VPS, Tailscale между площадками |
| Базы | общий PostgreSQL (CT 151): Authentik, Firefly, Vaultwarden |
| Мониторинг | Prometheus (CT 134), Alertmanager, Grafana + Loki (CT 113) |
| Логи | promtail на всех контейнерах → Loki |
| Доступность | Uptime Kuma (57 мониторов, CT 107) |
| Автоматизация | n8n (7 процессов), Node-RED, tg-admin-bot (CT 108) |
| Оповещения | Alertmanager → вебхук → n8n → Matrix/Telegram |
| Медиа | Sonarr, Radarr, Prowlarr, Bazarr, Jellyfin, Plex, Tautulli, Navidrome, Seerr |
| Резервные копии | vzdump по расписанию, ротация, Duplicati |
## Что добавил сегодня
* **Seerr** вместо Overseerr (см. часть 1).
* **Метрики медиасервисов**: 4 экспортёра (Sonarr, Radarr, Prowlarr, Bazarr)
→ Prometheus. Все цели `up`.
* **3 новых правила оповещений**: ошибка сбора метрик медиа, застрявшая
очередь загрузок, мало места на диске загрузок. Всего правил 10.
---
# Часть 3. План интеграций «высокого класса»
Разбит на волны. В каждой — что даёт и что нужно от вас.
## Волна 1 — наблюдаемость (сделано 50%)
| Шаг | Даёт | Состояние |
|---|---|---|
| Экспортёры медиа | очередь, библиотеки, диски, ошибки | **сделано** |
| Правила оповещений по медиа | узнаём о проблеме до того, как кончится место | **сделано** |
| Uptime Kuma → Prometheus | 57 мониторов в общей картине и в истории | нужно включить `/metrics` в Kuma (даёт ключ в настройках) |
| Проверка сертификатов (blackbox) | предупреждение за 14 дней до истечения | нужно решение: ставить blackbox_exporter |
| Дашборды Grafana | «Медиа», «Дом», «Резервные копии» | нужно: доступ к Grafana API (ключ) |
| Метрики Tautulli (просмотры) | кто что смотрит, топ контента | нужен ключ Tautulli API |
## Волна 2 — медиа как единая система
| Шаг | Даёт | Нужно от вас |
|---|---|---|
| Seerr → Matrix/Telegram | «запрос создан/одобрен/готов» | выбрать канал: Matrix-комната или Telegram-группа |
| Sonarr/Radarr → Seerr | «уже есть в библиотеке» без запроса | ничего (включу) |
| Prowlarr → Sonarr/Radarr | индексаторы в одном месте | проверить существующие связи |
| Bazarr → Sonarr/Radarr | субтитры | проверить |
| Jellyfin/Plex → Tautulli | статистика просмотров | ничего |
| Ежедневная сводка | что скачалось, что в очереди, что сломалось | канал оповещений |
## Волна 3 — сквозные сценарии (n8n)
| Сценарий | Что делает |
|---|---|
| **Умный запрос** | новый запрос в Seerr → проверка места и профиля → авто-одобрение или сообщение вам |
| **Отчёт о резервных копиях** | после vzdump проверяет архив, пишет в Matrix, при ошибке — тревога |
| **Разбор диска** | раз в сутки: что занимает место, топ-5 → сообщение |
| **Новый документ** | Paperless → уведомление + теги |
| **Новый коммит** | Gitea → уведомление в Matrix |
| **Недельный дайджест** | сводка по всем службам, аптайм, инциденты, место |
## Волна 4 — глубокая интеграция
| Что | Зачем |
|---|---|
| **Authentik → LDAP для служб** | единый справочник для тех, кто умеет LDAP |
| **Единый прокси проверки доступа** | аудит «кто куда ходил» в одном месте |
| **Оповещения о входах** | неудачный вход в Authentik → сообщение |
| **Автоочистка** | правила удаления старого из библиотек и бэкапов |
| **Резервные копии в объектное хранилище** | второй контур (S3-совместимый) |
| **Home Assistant ↔ сервисы** | статус служб на панели, кнопки действий |
## Волна 5 — качество жизни
- Единая панель (Dashy) со статусами из Prometheus и ссылками.
- Поиск по всем сервисам (Paperless, Linkding, Gitea, Nextcloud) — через n8n.
- Уведомления в Matrix-комнату по каждому событию с фильтрами.
- Экспорт статистики (что смотрели/читали) в дашборд.
---
# Часть 4. Что мне нужно от вас
1. **Канал оповещений**: Matrix-комната (какая) или Telegram-группа (какая)?
2. **Ключ Uptime Kuma** (Настройки → API Keys) — для метрик в Prometheus.
3. **Ключ Grafana** (Administration → Service accounts) — чтобы создать дашборды.
4. **Ключ Tautulli** (Настройки → Web Interface → API key).
5. **Решение по входу в Seerr**: Quick Connect (рекомендую) или пароли.
6. **Что важнее в первую очередь** из волн 3–4: назовите 2–3 сценария.
Всё, что не требует этих данных, могу делать сразу: связи Seerr ↔ arr,
уведомления Seerr в n8n, ежедневная сводка.