Files
buryan-infra/ops/media/MULTI-LIBRARY.md
T
buryan-agent 6efe4ac85e Персональные музыкальные библиотеки: у каждого своя
Музыка разложена по /mnt/media/music/users/<user>/; в Navidrome создана
отдельная библиотека на пользователя и настроен доступ через user_library
(каждый видит свою + общую).

Персональные токены: /root/.yandex-tokens/<user>.json, доступ по личным
ссылкам yandex.html?k=<секрет>. Неверный ключ — 403. sync_users.py проходит
по всем токенам и раскладывает лайки по папкам, затем полный скан Navidrome.
Cron 05:30 по 3 новых трека на пользователя.

roman: 463 трека, 2.3 ГБ. Изоляция проверена на двух тестовых пользователях
через Subsonic API: с библиотекой roman поиск «ATL» дал 5 треков, с пустой
библиотекой elena — 0.

Ловушки: перенос файлов только на узле (uid контейнера); пароли Navidrome
шифрует, вставка в БД не работает; CLI требует TTY (script + docker exec -it);
library.path уникален; старые media_file чистятся по path.
2026-10-20 14:34:50 +03:00

70 lines
3.9 KiB
Markdown

# Персональные музыкальные библиотеки
У каждого пользователя — своя библиотека: свои треки, свой аккаунт Яндекс
Музыки, своя папка. Чужое не видно.
## Как устроено
```
/mnt/media/music/users/<user>/<исполнитель>/<альбом>/<трек>.mp3
/root/.yandex-tokens/<user>.json токен пользователя (600)
/root/.yandex-keys.json персональные ссылки (600)
```
Navidrome: отдельная библиотека на пользователя (`library` + `user_library`).
| Библиотека | Папка | Кому видна |
|---|---|---|
| Общая музыка | /music/shared | всем |
| Музыка roman | /music/users/roman | roman |
| Музыка elena | /music/users/elena | elena |
| … | … | … |
## Как пользователь подключает свой аккаунт
Каждому выдаётся персональная ссылка вида
`https://status.buryans.ru/hub/yandex.html?k=<секрет>`.
1. Пользователь открывает ссылку — ключ определяет его личность.
2. Входит в свой Яндекс и вставляет ссылку с `access_token`.
3. Токен проверяется и сохраняется в `/root/.yandex-tokens/<user>.json`.
4. Ночью `sync_users.py` скачивает его «Мне нравится» в его папку.
5. Navidrome пересканирует — треки появляются только у него.
Неверный или чужой ключ даёт `403`, токен не сохраняется.
## Синхронизация
`sync_users.py` проходит по всем токенам, тянет лайки, раскладывает по
`users/<user>/`, затем делает `navidrome scan --full`.
Cron: ежедневно 05:30, по 3 новых трека на пользователя
(`sync_users.py 3`). Полная синхронизация — запуск без аргумента.
## Проверка изоляции
Создал двух тестовых пользователей с паролями и разными библиотеками:
```
libtest (библиотека roman) → поиск «ATL»: 5 треков
libtest2 (библиотека elena) → поиск «ATL»: 0 треков
```
Оба — через Subsonic API (`/rest/search3.view`). Затем тестовые удалены.
## Ловушки
1. **Перенос папок из контейнера не работает** — файлы принадлежат root узла,
в контейнере другой uid. Переносить надо на узле.
2. **Пароли Navidrome шифрует**, а не хранит bcrypt-хешем: вставка пользователя
прямо в базу даёт «Error decrypting user's password». Пользователей надо
создавать через CLI/UI, где шифрование делает сам Navidrome.
3. **CLI требует TTY** для ввода пароля. Работает так:
`printf 'pass\npass\n' | script -q -c "docker exec -i -t navidrome navidrome user create -u test" /dev/null`
4. **`library.path` уникален** — нельзя переиспользовать путь, сначала удалить
старую запись.
5. **Старые записи media_file** остаются при смене пути библиотеки и всплывают
как «библиотека 1: 17 треков». Чистятся удалением по `path like 'users/%'`.
6. **`ON CONFLICT` в SQL** — при ручной правке легко получить два `on conflict`
подряд; проверять `ast.parse` и живой запрос.