Files
buryan-infra/ops/media/COLLECTIONS-AND-DOWNLOADS.md

8.0 KiB
Raw Permalink Blame History

Медиа: загрузки и коллекции — ловушки и рецепты

Записано 28.10.2026 после разбора, почему «ничего не качается» и почему не получались коллекции.


1. Загрузки не работали неделю: права на /mnt/media/downloads

Симптом. Radarr показывает элементы в очереди со статусом warning, в сообщении qBittorrent is reporting an error; в qBittorrent торренты в состоянии error, прогресс 0%; каталог /mnt/media/downloads пуст.

В логе qBittorrent (/root/.local/share/qBittorrent/logs/qbittorrent.log внутри CT123):

Предупреждение об ошибке файла. Причина: «… file_open
(/data/downloads/…/file.mkv) error: Permission denied»

Причина. CT123 непривилегированный (unprivileged: 1), поэтому root внутри контейнера — это uid 100000 на хосте. Каталог /mnt/media/downloads принадлежал root:root с правами 775, то есть писать в него мог только хостовый root. Итог: qBittorrent не мог создать ни одного файла, а ошибка нигде не всплывала — очередь просто стояла.

Как проверить.

ls -ld /mnt/media/downloads                 # кто владелец на хосте
pct exec 123 -- sh -c 'touch /data/downloads/.probe && rm /data/downloads/.probe'
# Permission denied -> права не те

Как исправить.

chown 100000:100000 /mnt/media/downloads
mkdir -p /mnt/media/downloads/incomplete
chown 100000:100000 /mnt/media/downloads/incomplete
chmod 775 /mnt/media/downloads /mnt/media/downloads/incomplete

Тот же uid (100000) нужен Radarr/Sonarr — они тоже в непривилегированных CT, поэтому один владелец устраивает все стороны.


2. Профиль качества при добавлении фильма через API

При добавлении через POST /api/v3/movie нельзя брать «первый профиль из списка»: первым идёт SD. В результате 1080p-релизы отвергаются (Bluray-1080p is not wanted in profile), а качается 480p/XviD.

Правильно — выбирать по имени:

profiles = api('qualityprofile')
profile_id = next(p['id'] for p in profiles if p['name'] == 'HD-1080p')   # 4

Проверка после добавления: GET /api/v3/movie → qualityProfileId должен быть 4.


3. Коллекции в Jellyfin

Коллекция = BoxSet. Создаётся одним запросом:

JK=$(cat /root/.jellyfin-key)
curl -s -X POST -H "Authorization: MediaBrowser Token=\"$JK\"" \
  'http://192.168.1.103:8096/Collections?name=Властелин%20колец&ids=<id1>,<id2>,<id3>'

Условия, без которых коллекция бессмысленна:

  1. Не меньше двух фильмов с файлами — иначе она пустая. Проверять hasFile=true в Radarr и наличие файла в /mnt/media/movies.
  2. После импорта фильмов — пересчитать библиотеку, иначе Jellyfin их не увидит: POST /Library/Refresh или задача «Сканирование медиатеки».
  3. Идентификаторы брать из Jellyfin (/Items?IncludeItemTypes=Movie&SearchTerm=…), а не из Radarr — это разные id.

Проверка результата:

curl -s -H "Authorization: MediaBrowser Token=\"$JK\"" \
  'http://192.168.1.103:8096/Items?IncludeItemTypes=BoxSet&Recursive=true'
# в списке должна быть коллекция, а внутри — три фильма

4. Состояние на 28.10.2026

  • Каталог загрузок исправлен, загрузка работает (проверено: файлы растут).
  • Трилогия «Властелин колец» добавлена в Radarr (id 21, 22, 23), профиль HD-1080p, качаются extended-версии 1080p.
  • Коллекция «Властелин колец» будет создана после импорта — см. раздел 3.
  • Матрица снята с мониторинга (осталась в списке Radarr).

Уточнение: uid-ов два, и это важно

28.10.2026, после первых неудачных импортов выяснилось:

Кто uid внутри контейнера uid на хосте Что должно быть записываемым
qBittorrent (CT123, systemd, root) 0 100000 /mnt/media/downloads
Radarr (CT118, linuxserver, PUID 911) 911 100911 /mnt/media/movies
Sonarr (CT117, linuxserver) 911 100911 /mnt/media/series

То есть chown 100000 для каталога загрузок не помогает Radarr: он пишет как 100911 и получает Access to the path '/data/movies/…' is denied. Симптом в логе Radarr (/opt/radarr/config/logs/radarr.txt):

System.UnauthorizedAccessException: Access to the path
'/data/movies/The Lord of the Rings - …' is denied.

Правильно:

chown 100000:100000 /mnt/media/downloads     # qBittorrent
chown 100911:100911 /mnt/media/movies        # Radarr
chown 100911:100911 /mnt/media/series        # Sonarr

Проверка от имени процесса, а не от root CT:

pct exec 118 -- docker exec -u 911 radarr sh -c \
  'touch /data/movies/.probe && rm /data/movies/.probe'

Ещё одна деталь: импорт из торрента идёт копированием, пока раздача сидируется, поэтому большой файл появляется в медиатеке не сразу, и hasFile становится true только после завершения копии.


Итог 28.10.2026: коллекция «Властелин колец»

Собрана и проверена:

Фильм Файл Jellyfin
Братство кольца 5.5 ГБ есть
Две крепости 13 ГБ есть
Возвращение короля 6.5 ГБ есть

Коллекция (BoxSet) 81eb8f31…, внутри 3 фильма — проверено запросом /Items?ParentId=<id>&Recursive=true.

Ловушки, пойманные на этом шаге

  1. Каталог загрузок должен быть writable и на удаление. Radarr (uid 911 → host 100911) импортирует move-ом: копирует файл и удаляет исходник. Права 775 у каталога 100000:100000 давали Permission denied на удаление, хотя чтение работало. Итог: chmod 777 /mnt/media/downloads.
  2. Коллекция создаётся только из фильмов, которые уже есть в Jellyfin. Если третий фильм ещё не импортирован, он в коллекцию не попадёт. Дополнять: POST /Collections/<id>/Items?ids=<movieId>.
  3. После импорта нужен скан библиотеки (POST /Library/Refresh), иначе Jellyfin не видит новые файлы и коллекция собирается неполной.
  4. POST /Collections?name=…&ids=… возвращает {"Id": "…"} — это и есть id коллекции; проверять наличие через /Items?IncludeItemTypes=BoxSet.