171 lines
8.0 KiB
Markdown
171 lines
8.0 KiB
Markdown
# Медиа: загрузки и коллекции — ловушки и рецепты
|
||
|
||
Записано 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 не мог создать ни
|
||
одного файла, а ошибка нигде не всплывала — очередь просто стояла.
|
||
|
||
**Как проверить.**
|
||
|
||
```bash
|
||
ls -ld /mnt/media/downloads # кто владелец на хосте
|
||
pct exec 123 -- sh -c 'touch /data/downloads/.probe && rm /data/downloads/.probe'
|
||
# Permission denied -> права не те
|
||
```
|
||
|
||
**Как исправить.**
|
||
|
||
```bash
|
||
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.
|
||
|
||
Правильно — выбирать по имени:
|
||
|
||
```python
|
||
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. Создаётся одним запросом:
|
||
|
||
```bash
|
||
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.
|
||
|
||
**Проверка результата:**
|
||
|
||
```bash
|
||
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.
|
||
```
|
||
|
||
Правильно:
|
||
|
||
```bash
|
||
chown 100000:100000 /mnt/media/downloads # qBittorrent
|
||
chown 100911:100911 /mnt/media/movies # Radarr
|
||
chown 100911:100911 /mnt/media/series # Sonarr
|
||
```
|
||
|
||
Проверка от имени процесса, а не от root CT:
|
||
|
||
```bash
|
||
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`.
|
||
|