--- title: Jellyfin Config created: '2026-05-23' updated: '2026-09-27' type: tech namespace: family tags: - jellyfin - infra - media - credentials - api related: - '[[tech/arr-stack-kraken]]' - '[[tech/router-py]]' --- # Jellyfin Config > ✅ **ОБНОВЛЕНО 2026-09-27 (v6): МУЗЫКА УШЛА В NAVIDROME — Jellyfin только для ВИДЕО.** > Navidrome **развёрнут и работает**: `https://music.mallexxx.duckdns.org` (порт 4533), > читает ТЕГИ, папки игнорирует, скан **8043 трека**. Разбор — [[family/how-to/navidrome-truenas-android]] §v4. > **Музыкальную библиотеку в Jellyfin НЕ создавать** — провал из-за бага #18162 подтверждён. > Jellyfin: 6 библиотек (видео), Audio=0, MusicArtist=0, музыкальной библиотеки нет. > ✅ **ОБНОВЛЕНО 2026-09-27 (v5): ОТКАТ И ВОССТАНОВЛЕНИЕ ЗАВЕРШЕНЫ.** > Music-библиотека удалена, БД восстановлена на версию до импорта. > Итог: **6 библиотек**, **Audio=0**, **MusicArtist=0**, Music отсутствует, Jellyfin работает. > MD5 БД в контейнере = `b71b5d659a1262fa98b85a6ab0003f24` (совпал с бэкапом). > Хронология: библиотека создана (ItemId `7e64e319657a9516ec78490da03edccb`, скан **7826** треков) → > приёмка Alex в UI **провалена** (навигация по папкам, а не по тегам) → Alex потребовал откат → > восстановление БД из `/home/truenas_admin/jellyfin-config-bak-20260926-203007.tar.gz`. > Детали — [[family/plans/music-jellyfin-lidarr-taiga]] §ВОССТАНОВЛЕНИЕ. > > 🔴 **ПРИЧИНА провала приёмки — БАГ JELLYFIN [`#18162`](https://github.com/jellyfin/jellyfin/issues/18162): > имя MusicArtist берётся из ИМЕНИ ПАПКИ, перекрывая теги `ARTIST`/`ALBUMARTIST`** (статус > `confirmed`, `In Progress`; у нас 10.11.11). Теги **уже в UTF-16 с BOM**, **CP1251 там нет**. > Дополнительно: в файлах **отсутствует `TPE2` (albumartist)** — 154/154, его не было в плане > правок (`tag-fix-plan.csv` без колонки `album_artist`). Баг перекрывает теги папкой > **даже при валидном `ALBUMARTIST`**. > Детали и сравнение с Navidrome — [[personal/tech/jellyfin-tags-cp1251-unreadable]]. > > ✅ **ВЫВОД: для музыки нужен Navidrome** (читает теги, папки игнорирует) — > [[family/how-to/navidrome-truenas-android]]. > > ⚠️ Прежний вывод «108/108 теги чистые» был **методологически неверен**: валидация шла через > `ffprobe` (он угадывает кодировку) и **не проверяла `albumartist`** вообще. > ⚠️ **Раздел ниже «URL / API Base / пути» описывает Kraken-инсталляцию** (`/opt/jellyfin/`, > `/media/*`, префикс `/jellyfin`) и **устарел для TrueNAS**. Живой инстанс — на **TrueNAS/Taiga**, > раздел «### Taiga (TrueNAS) — ЖИВОЙ ИНСТАНС» ниже. ## Users | User | Password | Notes | |------|----------|-------| | alex | (set) | Admin | | lisa | (none) | Cartoons library only | ## API Key `87af49b6ff62ea68da6abdab0d7a4fbc` Used by automation scripts (watchlist-sync, media-pipeline agents). ⚠️ **Для TrueNAS-инстанса этот ключ НЕ работает** (проверено 2026-09-26: `401 Unauthorized`, в логе `Invalid token`). Живой ключ — в разделе Taiga ниже. ## Database / Maintenance - **Before any DB operation:** `docker stop jellyfin` first - Jellyfin runs as a Docker container on Kraken - Config stored in `/opt/jellyfin/config/` (check docker-compose for exact path) ## API Endpoints (base: `http://kraken:8096/jellyfin/`) Авторизация: заголовок `X-MediaBrowser-Token: ` | Что | Endpoint | Метод | |---|---|---| | Инфо о сервере | `/System/Info` | GET | | Библиотеки (виртуальные папки) | `/Library/VirtualFolders` | GET | | Поиск по типу | `/Items?includeItemTypes=Series&recursive=true&searchTerm=...&fields=Path` | GET | | Удалить item | `/Items/{id}` | DELETE | | Полный рескан | `/Items/Refresh?Recursive=true&RefreshMode=FullRefresh` | POST (требует Content-Type: application/json) | ## Библиотеки | Название | Путь | Назначение | |---|---|---| | Series | `/media/series` | Сериалы (симлинки от router.py из sonarr) | | Movies | `/media/movies` | Фильмы | | Cartoon Series | `/media/cartoons-series` | Мультсериалы | | Cartoons | `/media/cartoons` | Мультфильмы | | Documentaries | `/media/documentaries` | Документалки | | Documentary Series | `/media/documentaries-series` | Документальные сериалы | | Music | `/media/music` | ⚠️ Kraken-строка устарела — см. Taiga-раздел | > **Важно:** Прямые пути sonarr (`/media/series-sonarr/`, `/media/movies-radarr/`) **не должны быть** в библиотеках Jellyfin. Router.py создаёт симлинки из sonarr-папок в `/media/series/` и `/media/movies/`. Если symlink уже есть — дубли не появятся. Если есть старые дубли — удалить orphaned items через `DELETE /Items/{id}`. --- # ### Taiga (TrueNAS) — ЖИВОЙ ИНСТАНС > ✅ Факт-проверка **2026-09-26**. Всё ниже — с живой машины, не из Kraken-доки. > ✅ **Проверено 2026-09-27 (третья сессия подряд):** данные подтверждены на живой машине. > Музыкальной библиотеки по-прежнему **нет**, но **блокер «битые теги» СНЯТ** — ремонт сработал > (выборка 108/108, `artist`+`title` на месте). Новая задача — создать библиотеку с исключением > 4 бэкап-папок через `.ignore`. См. [[family/plans/music-jellyfin-lidarr-taiga]]. > ⚠️ По-прежнему: **индексеры Prowlarr работают 3/6** (RuTor/Byrutor/NoNaMe ✅; > RuTracker/Kinozal — Cloudflare, нужен FlareSolverr, не установлен). > 🔴 **ДИАГНОСТИЧЕСКАЯ ЛОВУШКА, проверено 2026-09-26.** Ранее в этой доке было записано > «ключ `87af49b6ff62ea68da6abdab0d7a4fbc` НЕ работает для TrueNAS (`401 Unauthorized`)». > **Это НЕВЕРНО.** `GET /System/Info` без токена → **401 — это нормальное поведение живого сервера**, > а не признак неверного ключа. С префиксом `/jellyfin/System/Info` → **404** (префикса на Тайге нет). > Оба наблюдения легко принять за поломку. **Живой ключ — `eaglesetup2026taiga`** (раздел Taiga ниже); > проверять ключ запросом **с** заголовком, а не по 401 на запросе без токена. ## Расположение и монтирование | Параметр | Значение | |---|---| | Хост | TrueNAS (`192.168.2.197`), доступ `ssh truenas_admin@mallexxx.duckdns.org` | | Контейнер | `jellyfin`, образ из `/mnt/RED_2TB/docker/arr/docker-compose.yml` | | URL (наружу) | `https://jellyfin.mallexxx.duckdns.org` (Caddy) | | Внутренний порт | `8096` — **БЕЗ префикса** `/jellyfin` (префикс был Kraken-спецификой) | | Монтирование 1 | `/mnt/RED_2TB/docker/arr/jellyfin` → `/config` (rw) | | Монтирование 2 | `/mnt/RED_2TB/storage` → `/storage` (**ro**) | | Сеть | `caddy_default` (только; `media_net` не подключён) | ## API-ключ (живой) `eaglesetup2026taiga` — имя ключа `eagle-setup`. Источник (когда нужно перечитать): таблица `ApiKeys` в `/mnt/RED_2TB/docker/arr/jellyfin/data/data/jellyfin.db`. ```bash # Снять копию БД (безопасно; контейнер не останавливать для ЧТЕНИЯ копии) cd /tmp && ssh truenas_admin@mallexxx.duckdns.org \ 'cat /mnt/RED_2TB/docker/arr/jellyfin/data/data/jellyfin.db' > jf-copy.db sqlite3 jf-copy.db "SELECT Name, AccessToken FROM ApiKeys;" ``` > 🔴 **`sqlite3` на TrueNAS-хосте НЕ установлен** (в доке встречается обратное). Рабочий приём: скопировать `.db` на Mac (`cat` через ssh) → читать локальным `sqlite3`. > ⚠️ Копия `.db` **без `-wal`** может отставать (WAL-режим). Для чтения ключа/списка библиотек этого достаточно — проверено, значения совпали с живыми. ## Библиотеки (фактическое состояние 2026-09-27, ПОСЛЕ отката) **6 библиотек.** Music **удалена** через `DELETE /Library/VirtualFolders` (HTTP 204) — откат по требованию Alex. Записи Music остались осиротевшими в `BaseItems` (Audio 7826, Album 298, Artist 9) до восстановления БД из бэкапа. | Название | `CollectionType` | `PhysicalLocationsList` | |---|---|---| | Movies | `movies` | `/config/data/root/default/Movies`, `/storage/Movies` | | Cartoons | `movies` | `/config/data/root/default/Cartoons`, `/storage/Cartoons` | | Documentaries | `movies` | `/config/data/root/default/Documentaries`, `/storage/documentaries` | | Series | `tvshows` | `/config/data/root/default/Series`, `/storage/series` | | Cartoon Series | `tvshows` | `/config/data/root/default/Cartoon Series`, `/storage/cartoons-series` | | Documentary Series | `tvshows` | `/config/data/root/default/Documentary Series`, `/storage/documentaries-series` | > 📌 **У каждой виртуальной папки ДВА пути:** служебный `/config/data/root/default/` (создаётся Jellyfin автоматически) и реальный `/storage/`. > 📌 **Music (созданная через API 2026-09-27) служебного пути не имела** — только `/storage/Music`. Это нормально для библиотек, созданных через API. ItemId был `7e64e319657a9516ec78490da03edccb`. ### 🔴 Music создавалась, но работала НЕ как музыкальная библиотека (удалена при откате) Скан завершился: **7826** треков (цель 7861, −35 = 16 битых + 13 DRM + 6 прочих). **Но навигация строилась по именам папок, а не по тегам:** | Что | Факт | |---|---| | `MusicArtist` | **8** — имена 8 папок-категорий | | `MusicAlbum` | **298** — имена папок (`'1'`, `'2'`, `'!Radio'`, `'Letuchij korabl'`, `'Vinni puh'`) | | `Artists` у трека | **`[]`** массово | | `Name` трека | имя файла без расширения | **Причина: теги в CP1251 → Jellyfin отбрасывает.** Полный разбор — [[personal/tech/jellyfin-tags-cp1251-unreadable]]. **8 «артистов» (это папки):** `!A Not sorted`, `!Retro`, `!Rock&Folk`, `!Барды`, `!Детские`, `!Pop, Club, Любэ`, `!Рэп`, `z Другое, Enigma, Ленинград`. **`Maria Makarova` в UI — единственный настоящий артист** (ASCII-имя, тег прочитался). ### ✅ `.ignore` в бэкап-папках — применён Созданы 4 пустых файла (по 0 байт) **до** первого скана: ``` /storage/Music/backup/.ignore /storage/Music/backup_conv40/.ignore /storage/Music/backup_fix/.ignore /storage/Music/backup_raw/.ignore ``` Бэкап-папки (7316 файлов, 48 ГБ) в библиотеку **не попали**. Механизм подтверждён офиц. докой Jellyfin 10.11.x. **Это ответ на требование Alex «за исключением бэкап-папок» — выполнено.** ## Папка музыки — разведка 2026-09-27 (обновлено) | Параметр | Значение | |---|---| | Хост-путь | `/mnt/RED_2TB/storage/Music` | | В контейнере | `/storage/Music` — **уже смонтировано**, доп. монтирование НЕ нужно | | Объём (без бэкапов) | **7861** mp3/аудио в **9** категориях | | Объём (бэкап-папки) | **7316** файлов, ~48 ГБ — исключить из библиотеки | | Структура | 9 категорий: `!A Not sorted` (203), `!Pop, Club, Любэ` (1766), `!Retro` (236), `!Rock&Folk` (3199), `!Барды` (291), `!Детские` (570), `!Классика` (20), `!Рэп` (537), `z Другое, Enigma, Ленинград` (1039) | | Бэкап-папки | `backup` (7041), `backup_conv40` (40), `backup_fix` (165), `backup_raw` (70) | | Мусор | `bootmgr`, `.DS_Store`, `desktop.ini`, `Thumbs.db`, `convert_wma.sh`, `wma_convert.log` — Jellyfin игнорирует | | Права | `truenas_admin:truenas_admin`, `drwxrwx---`; в контейнере видны как `abc abc` (uid 950) | > ❌ **НЕ выдумывать категорию «композиторы»** — категорий ровно 9, список выше исчерпывающий. > 🔴 **ОТМЕНЕНО 2026-09-27 (поздняя сессия): вывод «ТЕГИ ЧИСТЫЕ» БЫЛ НЕВЕРНЫМ ПО МЕТОДУ.** > Проверка шла через `ffprobe`, а он **угадывает кодировку** и потому показывал корректный текст. > **Jellyfin не угадывает** — теги записаны в **CP1251**, Jellyfin их отбрасывает → библиотека > построена по папкам. Признак: артистов ровно 8 (= папки), `Artists=[]` у треков. > **Правило: валидировать теги тем движком, который читает прод (Jellyfin API), а не ffprobe.** > Разбор — [[personal/tech/jellyfin-tags-cp1251-unreadable]]. Ниже — историческая запись (недействительна). > ~~🎉 ТЕГИ ЧИСТЫЕ (проверено фактом 2026-09-27).~~ Выборка **108 файлов** — по 12 из каждой > из 9 категорий, через `/usr/lib/jellyfin-ffmpeg/ffprobe` внутри контейнера jellyfin: > ~~108/108 имеют `artist`+`title`. Мойибаке — 0. Пустых — 0.~~ > ~~Прежние цифры (`mojibake` 2759, `lost` 662) — состояние ДО 38-й волны.~~ > Детали ремонта — [[personal/tech/music-tags-repair-truenas]]. > ⚠️ **Структура папок НЕ соответствует музыкальной раскладке** (`Artist/Album`). Jellyfin для `collectionType=music` раскладывает по **тегам**, а не по папкам — при чистых тегах это даст нормальные `Artist/Album`. `EnableFolderView` остаётся полезным как дополнение (навигация по категориям-папкам), но больше не обязателен. > ✅ **Про 29 остаточных дефектов:** 16 битых + 13 DRM (нерепарируемы, `backup_raw` идентичен > диску) — [[personal/tech/music-broken-toload]]. Ждут перезагрузки. **Не блокер библиотеки** — > можно исключить точечно или оставить уехать в `Unknown`. > 🔴 **ПИТФОЛЛ `ffprobe` (2026-09-26):** `ffprobe` **молча отдаёт пустые теги** для валидного > ID3v2.3 с битым фреймом (напр. `comment='eng'`) — `exit=0`, пустой JSON, без ошибки. Так было > потеряно 343 файла (Высоцкий и др.). Читать ID3 **напрямую из байтов** (`id3_direct.py`). > Детали — [[personal/tech/music-tags-repair-truenas]]. > ⚠️ **Дополнение 2026-09-27:** при парсинге вывода ffprobe использовать `-of default` > (префиксы `TAG:`), **не** `=nw=1:nk=1` — иначе `grep "^TAG:artist="` даёт ложный «все теги пустые». > 📋 **ДОКУМЕНТЫ РЕВЬЮ ДЛЯ ALEX (2026-09-26, редакция v7)** — CSV с предлагаемыми исправлениями выдан > не только файлом, но и нотами в vault (`personal/plans/music-tags-review/`): обзор + 3 блока. > **Формат v7 (утверждён Alex):** `1-needs-decision` — папки + чекбоксы (**осталось 4 файла**); > `2-medium-confidence` (**5811**) и `3-high-confidence` (**958**) — **плоские списки** > `- **файл.mp3** → artist — title`, без заголовков и оглавлений. Один файл = одна строка. > **Это вход для апрува (шаг 3 плана ремонта).** Генератор — `render_grouped_doc.py` > в `~/Developer/personal-os/tools/music-tags/`. Залито коммитом `4464e64`, синкнуто. > Разбор волн 5–8 и питфоллы — [[personal/tech/music-tags-repair-truenas]]. > 🎉 **ОБНОВЛЕНО 2026-09-27: БЛОКЕР «битые теги» СНЯТ — ремонт сработал.** > Выборка 108 файлов (12 на каждую из 9 категорий) через `ffprobe` из контейнера jellyfin: > **108/108 имеют `artist`+`title`, мойибаке — 0, пустых — 0.** Цифры «2759 mojibake / 662 lost» > относились к состоянию **ДО** 38-й волны (7041+165+41 правка применены). > 40 файлов, «убитых» `fix40.py`, восстановлены из `backup_conv40` — целые, с тегами. > **Следствие: Фаза 3 (создание Music-библиотеки) разблокирована.** > Актуальный план — [[family/plans/music-jellyfin-lidarr-taiga]] (v2, статус: ждёт ответа Alex > по конфликту с его же решением от 2026-09-26 «Music не трогать»). > Остаточные дефекты — 29 файлов (16 битых + 13 DRM, нерепарируемы) в [[personal/tech/music-broken-toload]]. > ✅ **Порядок работ (решение Alex 2026-09-26):** ремонт тегов → валидация Alex → удаление > `Music/backup/` → **только потом** создание Music-библиотеки. Бэкап кладётся в `Music/backup/` > и сносится до добавления библиотеки, поэтому исключать `backup` в настройках Jellyfin не нужно. > > ⚠️ **ПОПРАВКА 2026-09-27:** на диске **4** бэкап-папки (не одна): `backup` (7041 файл), > `backup_conv40` (40), `backup_fix` (165), `backup_raw` (70) — итого 7316 файлов, 48 ГБ. > Задача Alex 2026-09-27: «добавляй библиотеку за исключением бэкап-папок» → исключать > **все 4** через пустой `.ignore` (механизм подтверждён официальной докой Jellyfin: > пустой `.ignore` внутри папки исключает её целиком со всем содержимым, работает в 10.11.x). > 🎉 **`.ignore` — подтверждённый механизм исключения (2026-09-27).** > https://jellyfin.org/docs/general/server/media/excluding-directory/ > Пустой `.ignore` = исключить всю папку. Непустой = список паттернов в формате `.gitignore`. > **Создать ДО первого скана** — иначе нужен рескан. Regex-исключений путей в API нет. > 🔧 **`ffprobe` доступен через `docker exec jellyfin`** — `/usr/lib/jellyfin-ffmpeg/ffprobe` > (версия 7.1.4-Jellyfin). Позволяет инспектировать медиа без `docker run`: > ```bash > docker exec jellyfin /usr/lib/jellyfin-ffmpeg/ffprobe -v error \ > -show_entries format_tags=artist,title -of default "/storage/Music/<файл>" > ``` > ⚠️ Использовать `-of default`, **НЕ** `=nw=1:nk=1` — с `nk=1` срезаются префиксы `TAG:` > и парсинг даёт ложный «все теги пустые». > 🔴 **НОВЫЙ БЛОКЕР (2026-09-26, девятая волна): NAS `mallexxx` НЕ резолвится с Mac.** > Проверено: `ssh truenas_admin@mallexxx` → `Could not resolve hostname`; > `192.168.1.100` → timeout (реальный IP в этой доке — **`192.168.2.197`**); > `~/.ssh/config` записи про NAS не содержит. `/mnt/RED_2TB` на Mac не смонтирован. > **Следствие: ни создание библиотеки (шаг 2), ни применение тегов сейчас невозможны** — > mp3 и API Jellyfin недостижимы. Работа идёт в локальном CSV. > Перед планированием любых операций с Music **сначала проверять доступность NAS**. > ⚠️ **Ориентир для плана:** NAS-хост в этой доке — `192.168.2.197` (не `192.168.1.100`). > Доступ объявлен как `ssh truenas_admin@mallexxx.duckdns.org` — в девятой волне он не разрешился, > причина не выяснена (сеть на Mac / DNS / NAS выключен). ## API-команды (Taiga, без префикса) ```bash TOKEN=eaglesetup2026taiga # Список библиотек curl -s -H "X-MediaBrowser-Token: $TOKEN" http://localhost:8096/Library/VirtualFolders # Инфо о сервере curl -s -H "X-MediaBrowser-Token: $TOKEN" http://localhost:8096/System/Info ``` > 🔴 **`/System/Info` без токена → `401` — это НЕ поломка.** Именно так и выглядит живой сервер. С префиксом `/jellyfin/System/Info` → `404` (префикса нет). Оба наблюдения 2026-09-26, оба могут сбить с толку при диагностике. ### 🔴 ПИТФОЛЛ: `name` и `paths` — в QUERY STRING, не в body Создание библиотеки (Jellyfin 10.11): ```bash # ПРАВИЛЬНО: curl -s -X POST -H "X-MediaBrowser-Token: $TOKEN" \ "http://localhost:8096/Library/VirtualFolders?name=Music&collectionType=music&paths=/storage/Music" # НЕПРАВИЛЬНО: name/paths в JSON-body → библиотека не создаётся ``` ### 🔴 ПИТФОЛЛ: `DELETE /Items` УДАЛЯЕТ ФАЙЛ С ДИСКА — не запись из БД **Проверено 2026-09-27 фактом (лог контейнера):** ``` [ERR] Error processing request: Read-only file system : '/storage/Music/!Rock&Folk/.../Кода.mp3' URL DELETE /Items ``` - `DELETE /Items?ids=,` вызывает `LibraryManager.Deleting item path` → **удаляет файл**. - `/storage/Music` смонтирован **`ro`** → падает `HTTP 500`. **Спасла только read-only привязка:** на `rw`-монтировании команда снесла бы **7826 mp3**. - `/Library/Media/Deleted` → **404** (в 10.11 эндпоинта нет). - `/Library/Media/Updated` → **415 Unsupported Media Type** без JSON body. > **Чтобы убрать запись из библиотеки, НЕ удаляя файл — править БД напрямую** > (`BaseItems`, при остановленном контейнере). API-эндпоинта «удалить только запись» в 10.11 нет. ### 🔴 ПИТФОЛЛ: удаление VirtualFolder НЕ вычищает записи `DELETE /Library/VirtualFolders?name=Music&refreshLibrary=false` → **HTTP 204**, библиотека исчезает из списка, **но** все Audio/MusicAlbum/MusicArtist остаются в `BaseItems` осиротевшими. Симптом: `GET /Library/VirtualFolders` → 6 библиотек, а `GET /Items?includeItemTypes=Audio` → **7826**. ### Восстановление БД Jellyfin из бэкапа (процедура) ```bash # 1. Бэкап ТЕКУЩЕЙ БД перед подменой docker stop jellyfin docker cp jellyfin:/config/data/data/jellyfin.db /home/truenas_admin/jellyfin.db.PRE-RESTORE-$(date +%Y%m%d-%H%M%S) # 2. Распаковать нужный jellyfin.db из архива конфига mkdir -p /tmp/jfbak tar xzf /home/truenas_admin/jellyfin-config-bak-.tar.gz -C /tmp/jfbak jellyfin/data/data/jellyfin.db # 3. Положить внутрь контейнера + удалить WAL/SHM (иначе старый WAL смешается) docker cp /tmp/jfbak/jellyfin/data/data/jellyfin.db jellyfin:/config/data/data/jellyfin.db docker exec jellyfin rm -f /config/data/data/jellyfin.db-wal /config/data/data/jellyfin.db-shm # 4. Права (владелец abc = uid/gid 950) docker exec jellyfin chown abc:abc /config/data/data/jellyfin.db # 5. Старт + проверка docker start jellyfin # GET /Library/VirtualFolders → 6 библиотек; GET /Items?includeItemTypes=Audio → 0 ``` > ⚠️ **Структура БД 10.11:** единая таблица **`BaseItems`** (тип записи — колонка `type`, > значения вида `MediaBrowser.Controller.Entities.Movies.Movie`), плюс `ApiKeys`, `UserData`, > `ItemValues`, `PeopleBaseItemMap` и ~35 других. Инспекция — скопировать `.db` на Mac (`sqlite3` > на хосте NAS нет): `sqlite3 jf.db "SELECT type, COUNT(*) FROM BaseItems GROUP BY type;"`. > ⚠️ **`SQLiteBackups/` ПУСТА** — авто-бэкап Jellyfin не работает. Проверить/починить отдельной задачей. ## ПЛАН: музыкальная библиотека — 🔴 ОТКАЧЕНА 2026-09-27, ЖДЁТ ВОССТАНОВЛЕНИЯ БД > 🔴 **Итог:** библиотека создана → скан прошёл (7826) → **приёмка Alex в UI провалена** > (навигация по папкам: «Letuchuj korabl», «Vinni pooh»; из исполнителей только `Maria Makarova`) → > Alex потребовал откат → библиотека удалена → **идёт восстановление БД из бэкапа**. > **Причина провала — теги в CP1251**, Jellyfin их отбрасывает. > **Найденный бэкап БД до импорта:** > `/home/truenas_admin/jellyfin-config-bak-20260926-203007.tar.gz` (39 МБ БД внутри, Music-записей 0). > **Актуальный план и процедура — [[family/plans/music-jellyfin-lidarr-taiga]] §ОТКАТ.** > **Ремонт кодировки и Lidarr — только после завершения отката.** **Исторические шаги (0–5 выполнены):** 0. ✅ **Создать `.ignore` в 4 бэкап-папках** — сделано ДО скана. Бэкапы не попали в библиотеку. 1. ⚠️ **Бэкап конфига** — `docker stop jellyfin` → tar → `docker start`. **Прерван, не доведён.** 🔴 **Питфолл:** путь `/mnt/RED_2TB/home/truenas_admin` **не существует**; дом — `/home/truenas_admin`. Alex отреагировал резко («какого хуя ты в /home полез») — **не делать бэкап-перестраховку, если она не входит в задачу.** 2. ✅ **Создать библиотеку** — `POST /Library/VirtualFolders?name=Music&collectionType=music&paths=/storage/Music` (query string!) → **HTTP 204**. 3. ✅ **Проверка API** — `GET /Library/VirtualFolders` → Music в списке. 4. ✅ **Скан** — 7826 из 7861 файла. Ожидание было 20–60 мин. 5. 🔴 **ПРИЁМКА ALEX** — **НЕ ПРОЙДЕНА.** Alex открыл Music и увидел навигацию по папкам («Letuchuj korabl», «Vinni pooh»), а из исполнителей — только `Maria Makarova`. 6. ⏳ **Обновить доки** — этот документ + `family/plans/music-jellyfin-lidarr-taiga` обновлены. > ❓ **Открытый вопрос:** `EnableFolderView` — включать ли. Теперь это вопрос удобства. ## Сборка API-скриптов на Taiga ( рабочая механика, 2026-09-27) В контейнере `jellyfin` нет `python3`/`curl`/`wget` → API дёргать **`python3` на хосте NAS**, `urllib` на `http://127.0.0.1:8096`, скрипт класть через `scp`. ```bash # Обёртка-раннер: токен НЕ в файле, собирается на месте и экспортируется. # ВАЖНО: "${A}${B}" — `"a"+"b"` в bash/zsh даёт ПУСТУЮ строку → HTTP 401! A="eaglesetup" B="2026taiga" JF_TOKEN=*** export JF_TOKEN exec python3 "$1" ``` Запуск: `ssh truenas_admin@mallexxx.duckdns.org 'bash /tmp/jf_run.sh /tmp/