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

171 lines
8.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Медиа: загрузки и коллекции — ловушки и рецепты
Записано 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`.