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

3.9 KiB

Персональные музыкальные библиотеки

У каждого пользователя — своя библиотека: свои треки, свой аккаунт Яндекс Музыки, своя папка. Чужое не видно.

Как устроено

/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 и живой запрос.