8.0 KiB
Медиа: загрузки и коллекции — ловушки и рецепты
Записано 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>'
Условия, без которых коллекция бессмысленна:
- Не меньше двух фильмов с файлами — иначе она пустая. Проверять
hasFile=trueв Radarr и наличие файла в/mnt/media/movies. - После импорта фильмов — пересчитать библиотеку, иначе Jellyfin их не увидит:
POST /Library/Refreshили задача «Сканирование медиатеки». - Идентификаторы брать из 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.
Ловушки, пойманные на этом шаге
- Каталог загрузок должен быть writable и на удаление. Radarr (uid 911 →
host 100911) импортирует move-ом: копирует файл и удаляет исходник. Права
775 у каталога
100000:100000давалиPermission deniedна удаление, хотя чтение работало. Итог:chmod 777 /mnt/media/downloads. - Коллекция создаётся только из фильмов, которые уже есть в Jellyfin.
Если третий фильм ещё не импортирован, он в коллекцию не попадёт.
Дополнять:
POST /Collections/<id>/Items?ids=<movieId>. - После импорта нужен скан библиотеки (
POST /Library/Refresh), иначе Jellyfin не видит новые файлы и коллекция собирается неполной. POST /Collections?name=…&ids=…возвращает{"Id": "…"}— это и есть id коллекции; проверять наличие через/Items?IncludeItemTypes=BoxSet.