docs(install): music on a local disk at /mnt/music, repo in /opt/pipu-music

Add an install step for mounting the music disk via fstab and wire it into
the stack: LIBRARY_HOST in .env points at the host folder, compose mounts it
as /library-host (read-only for api, nginx and analyzer; writable only for
storage-agent), nginx serves it through X-Accel, and install.sh validates the
path and records it in .env.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

deploy/.env.example

@@ -4,6 +4,9 @@
 # PIPU_VERSION проставляет update.sh по git-тегу — вручную не менять
 PIPU_VERSION=dev
 PIPU_DATA=/srv/pipu
+# Папка с музыкой на локальном диске сервера (источники type=local), например смонтированный диск.
+# Пусто — $PIPU_DATA/library-host. NFS-хранилища сюда не относятся: их подключает админка.
+LIBRARY_HOST=
 
 # --- Домен и HTTPS (docs/install-guide.md) ---
 # Вариант А: встроенный Caddy с Let's Encrypt — оставьте строку COMPOSE_FILE и заполните DOMAIN, ACME_EMAIL.

deploy/compose.yaml

@@ -17,6 +17,14 @@ x-library-ro: &library-ro
   read_only: true
   bind: { propagation: rslave }
 
+# Локальная музыка (источники type=local): каталог хоста, например смонтированный диск /mnt/music.
+# Пишет в него только storage-agent (импорт одобренных загрузок), остальным — только чтение.
+x-library-host-ro: &library-host-ro
+  type: bind
+  source: ${LIBRARY_HOST:-${PIPU_DATA:-/srv/pipu}/library-host}
+  target: /library-host
+  read_only: true
+
 x-restart: &restart
   restart: unless-stopped
 
@@ -31,6 +39,7 @@ services:
     ports: ["${HTTP_PORT:-80}:80"]
     volumes:
       - *library-ro
+      - *library-host-ro
       - ${PIPU_DATA:-/srv/pipu}/cache:/cache:ro
       - ${PIPU_DATA:-/srv/pipu}/uploads:/uploads:ro
     depends_on: [api]
@@ -48,6 +57,7 @@ services:
       DATABASE_URL: postgres://pipu:${POSTGRES_PASSWORD:?заполните POSTGRES_PASSWORD в .env (sudo ./install.sh)}@postgres:5432/pipu?sslmode=disable
     volumes:
       - *library-ro
+      - *library-host-ro
       - ${PIPU_DATA:-/srv/pipu}/cache:/cache
       - ${PIPU_DATA:-/srv/pipu}/updates:/updates
       - ${PIPU_DATA:-/srv/pipu}/uploads:/uploads
@@ -75,6 +85,9 @@ services:
         source: ${PIPU_DATA:-/srv/pipu}/library
         target: /library
         bind: { propagation: rshared }
+      - type: bind
+        source: ${LIBRARY_HOST:-${PIPU_DATA:-/srv/pipu}/library-host}
+        target: /library-host
       - ${PIPU_DATA:-/srv/pipu}/uploads:/uploads:ro
 
   recommender:
@@ -102,6 +115,7 @@ services:
       LOG_LEVEL: ${LOG_LEVEL:-info}
     volumes:
       - *library-ro
+      - *library-host-ro
       - ${PIPU_DATA:-/srv/pipu}/models:/models
     deploy: { resources: { limits: { cpus: "4" } } }
     depends_on:

deploy/install.sh

@@ -17,6 +17,16 @@ mkdir -p "$DATA"/{library,library-host,cache/transcode,cache/covers,postgres,mei
 chown 65532:65532 "$DATA"/{cache,cache/transcode,cache/covers,updates,uploads}
 chown 10001:10001 "$DATA/models"
 
+# Папка с локальной музыкой: sudo LIBRARY_HOST=/mnt/music ./install.sh (или LIBRARY_HOST в .env)
+LIBRARY_HOST="${LIBRARY_HOST:-$( [ -f .env ] && sed -n 's/^LIBRARY_HOST=//p' .env || true )}"
+if [ -n "$LIBRARY_HOST" ]; then
+  if [ ! -d "$LIBRARY_HOST" ]; then
+    echo "LIBRARY_HOST=$LIBRARY_HOST: каталога нет — смонтируйте диск с музыкой (docs/install-guide.md, шаг 4)" >&2
+    exit 1
+  fi
+  findmnt -n --target "$LIBRARY_HOST" -o TARGET,SOURCE | sed 's/^/→ музыка: /'
+fi
+
 # storage-agent монтирует NFS внутрь $DATA/library; чтобы точки монтирования видели другие контейнеры,
 # каталог должен быть отдельной точкой монтирования с shared propagation.
 if ! findmnt -n "$DATA/library" >/dev/null 2>&1; then
@@ -50,10 +60,19 @@ secret() { head -c 32 /dev/urandom | base64 | tr -d '/+=' | head -c 40; }
 if [ ! -f .env ]; then
   echo "→ .env из .env.example"
   cp .env.example .env
-  sed -i "s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$(secret)|; s|^MEILI_MASTER_KEY=.*|MEILI_MASTER_KEY=$(secret)|; s|^INTERNAL_TOKEN=.*|INTERNAL_TOKEN=$(secret)|; s|^PIPU_DATA=.*|PIPU_DATA=$DATA|" .env
+  sed -i "s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$(secret)|; s|^MEILI_MASTER_KEY=.*|MEILI_MASTER_KEY=$(secret)|; s|^INTERNAL_TOKEN=.*|INTERNAL_TOKEN=$(secret)|; s|^PIPU_DATA=.*|PIPU_DATA=$DATA|; s|^LIBRARY_HOST=.*|LIBRARY_HOST=$LIBRARY_HOST|" .env
   chmod 600 .env
   chown "$OWNER" .env
   echo "  Заполните в .env: DOMAIN и ACME_EMAIL (или настройте свой прокси — docs/install-guide.md)"
 fi
 
+# LIBRARY_HOST, переданный при повторном запуске, попадает и в уже существующий .env
+if [ -n "$LIBRARY_HOST" ]; then
+  if grep -q '^LIBRARY_HOST=' .env; then
+    sed -i "s|^LIBRARY_HOST=.*|LIBRARY_HOST=$LIBRARY_HOST|" .env
+  else
+    echo "LIBRARY_HOST=$LIBRARY_HOST" >> .env
+  fi
+fi
+
 echo "Готово. Сборка и запуск последнего релиза: ./update.sh"

deploy/nginx/default.conf.template

@@ -48,6 +48,7 @@ server {
 
     # Аудио и обложки отдаёт nginx по заголовку X-Accel-Redirect от api (docs/playback.md).
     location /_internal/library/ { internal; alias /library/;          sendfile on; aio threads; }
+    location /_internal/library-host/ { internal; alias /library-host/; sendfile on; aio threads; }
     location /_internal/cache/   { internal; alias /cache/transcode/;  sendfile on; }
     location /_internal/covers/  { internal; alias /cache/covers/;     expires 30d; }
     location /_internal/uploads/ { internal; alias /uploads/;          sendfile on; }