11 KiB
title, created, updated, type, namespace, tags, related
| title | created | updated | type | namespace | tags | related | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Jellyfin Config | 2026-05-23 | 2026-09-26 | tech | family |
|
|
Jellyfin Config
⚠️ Обновлено 2026-09-26. Раздел ниже «URL / API Base / пути» описывает Kraken-инсталляцию (
/opt/jellyfin/,/media/*, префикс/jellyfin) и устарел для TrueNAS. Живой инстанс — на TrueNAS/Taiga, раздел «### Taiga (TrueNAS) — ЖИВОЙ ИНСТАНС» ниже. Проверено фактом 2026-09-26.
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 jellyfinfirst - 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: <API_KEY>
| Что | 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 | Музыка |
Важно: Прямые пути 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-доки.
Расположение и монтирование
| Параметр | Значение |
|---|---|
| Хост | 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.
# Снять копию БД (безопасно; контейнер не останавливать для ЧТЕНИЯ копии)
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-26)
6 библиотек в BaseItems (тип MediaBrowser.Controller.Entities.CollectionFolder):
| Название | 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/<Name>(создаётся Jellyfin автоматически) и реальный/storage/<Folder>. Реальный путь дополнительно виден какMediaBrowser.Controller.Entities.Folderс собственнымId. Music-библиотеки на 2026-09-26 НЕТ (в доке строкаMusicбыла пустой и остаётся незаполненной — см. план ниже).
Папка музыки — разведка 2026-09-26
| Параметр | Значение |
|---|---|
| Хост-путь | /mnt/RED_2TB/storage/Music |
| В контейнере | /storage/Music — уже смонтировано, доп. монтирование НЕ нужно |
| Объём | 7890 аудиофайлов (mp3/flac/m4a/ogg/wav/opus/aac) |
| Структура | 8 категорий: !A Not sorted, !Pop, Club, Любэ, !Retro, !Rock&Folk, !Барды, !Детские, !Классика, !Рэп, z Другое, Enigma, Ленинград |
| Мусор | bootmgr, .DS_Store, desktop.ini, Thumbs.db, convert_wma.sh, wma_convert.log — Jellyfin игнорирует |
| Права | truenas_admin:truenas_admin, drwxrwx--- (для PUID/PGID 921 путь доступен — /storage монтируется целиком) |
⚠️ Структура папок НЕ соответствует музыкальной раскладке (
Artist/Album). Jellyfin дляcollectionType=musicраскладывает по тегам, а не по папкам. Категории вида!Rock&Folk— «мусорные» имена из файловой системы, не артисты. Ожидаемый риск: файлы с пустыми тегами уедут вUnknown Artist. Вариант митигации —EnableFolderViewв настройках библиотеки (даёт навигацию по физическим папкам).
API-команды (Taiga, без префикса)
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):
# ПРАВИЛЬНО:
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 → библиотека не создаётся
ПЛАН: добавить музыкальную библиотеку (согласован 2026-09-26, НЕ ВЫПОЛНЕН)
6 шагов, в порядке исполнения:
- Бэкап конфига —
docker stop jellyfin→ tar/mnt/RED_2TB/docker/arr/jellyfin/→docker start jellyfin. Без остановки бэкап БД битый (WAL). - Создать библиотеку —
POST /Library/VirtualFolders?name=Music&collectionType=music&paths=/storage/Music(query string!). - Проверка API —
GET /Library/VirtualFolders→ Music в списке. - Скан — дождаться индексации 7890 файлов (~10–30 мин).
- ПРИЁМКА ALEX — открыть
https://jellyfin.mallexxx.duckdns.org→ вкладка Music → треки видны. Приёмка = видно в UI, не «API отвечает». - Обновить доки после подтверждения — таблица библиотек здесь +
family/projects/media-toolbox-taiga.md.
❓ Открытый выбор перед шагом 2: включать ли
EnableFolderView(навигация по папкам вместо тегов). Решается после выборочной проверки тегов файлов.
Связанные заметки
- family/projects/media-toolbox-taiga — *arr стек на Taiga (Prowlarr/Radarr/Sonarr/Transmission/Jellyfin)
- family/how-to/truenas-infrastructure — TrueNAS: контейнеры, доступ, структура пула
- family/how-to/navidrome-truenas-android — альтернативный музыкальный сервер (Navidrome) на той же папке
Music