[2026-09-27] eagle: family/how-to/navidrome-truenas-android.md personal/plans/tagwriter-container.md

This commit is contained in:
Alexey Martemyanov committed 2026-09-27 18:32:27 +06:00
1 parent 96123c9825
commit 54adfa9a5a
2 files changed
+61 -26

No files matched your search

+40 -16
View File
@@ -1,8 +1,9 @@
# Музыкальный плеер с TrueNAS на Android
**Статус:** ✅ **РАЗВЁРНУТ 2026-09-27** — Navidrome на TrueNAS, работает, скан завершён (8043 трека)
**Статус:** ✅ **РАЗВЁРНУТ 2026-09-27** — Navidrome на TrueNAS, работает, скан завершён (8043 трека).
🔴 **2026-09-27 (сессия 22):** теги 306 исправлены ✅, но **rescan НЕ помог** — в БД остались **14 сирот** `album` в скобках. `restart` и **пересоздание контейнера** дают `fullScan=false`, теги не перечитываются. Следующий шаг: **`touch` 306 файлов** (mtime) → полный скан.
**Дата:** 2026-05-10
**Обновлено:** 2026-09-27 (v4 — фактический деплой)
**Обновлено:** 2026-09-27 (v6 — rescan не помог, 14 сирот, путь через mtime)
---
@@ -320,36 +321,54 @@ folder="!Pop, Club, Любэ/Дискотека Авария/Москва пьё
**Артефакт для просмотра (запрошен у Alex, ещё не выгружен):** CSV `путь + текущий album + title`
по **306** файлам со «скобочным» album, топ-20 для глазной вычитки.
## ⏳ АКТИВНО (2026-09-27): БОЕВОЙ ПРОГОН 306 ВЫПОЛНЕН — НУЖЕН ПОЛНЫЙ RESCAN
## 🔴 АКТИВНО (2026-09-27, сессия 22): RESCAN НЕ ПОМОГ — 14 СИРОТ ОСТАЛИСЬ
> **Alex: «Navidrome rescan теперь надо»**
> **Alex: «Navidrome rescan теперь надо»** → затем **«Просто контейнер пересоздай»**
**Факт: теги на диске исправлены, но БД Navidrome содержит И СТАРЫЕ, И НОВЫЕ альбомы.**
```bash
DB=/mnt/RED_2TB/docker/navidrome/data/navidrome.db
sqlite3 "file:$DB?mode=ro" "SELECT COUNT(*) FROM album WHERE name LIKE '(%';" # → 14
sqlite3 "file:$DB?mode=ro" "SELECT COUNT(*) FROM album WHERE name LIKE '(%';" # → 14 (до и после)
```
| Что | Значение |
|---|---|
| альбомов в БД | 967 |
| `album` целиком в скобках | **14** ← не вычищены |
| `album` целиком в скобках | **14** ← не вычищены (число НЕ изменилось от rescan) |
| новые значения (`Философские`, `Морские`, `Москва пьёт пиво`, `Старые хиты`, `Дискотека Авария`, `Retro`, `Владимир Высоцкий`, `Несчастный Случай`, `zvezda`) | ✅ присутствуют |
**Причина:** `ND_SCANSCHEDULE=1h` + watcher **добавили** новые альбомы, но **не удалили** старые
записи, оставшиеся без файлов. Инкрементальный скан в Navidrome не чистит сироты сам.
### ❌ ЧТО ПРОБОВАЛОСЬ И НЕ ПОМОГЛО (факт)
**Варианты rescan (не выполнено, ждёт слова Alex):**
| # | Способ | Оценка |
| # | Способ | Результат |
|---|---|---|
| 1 | `docker restart navidrome` — полный скан на старте | ✅ предпочтительно, пароль не нужен |
| 2 | Дождаться планового скана (`1h`) | ⏳ не чистит автоматически, вероятно не поможет |
| 3 | Rescan через UI/API | требует пароль `navi_admin` — **неизвестен, не выдумывать** |
| 1 | `docker restart navidrome` | ❌ лог: `fullScan=false` → теги не перечитаны, всё те же **14** |
| 2 | `docker compose down` + `up -d` (**пересоздание контейнера**) | ❌ лог: `fullScan=false`, `duration=3.12s` → снова **14** |
| 3 | Проверка БД после обоих | `LIKE '(%'` = **14** (число не двинулось) |
**Проверка после rescan:** тот же запрос `LIKE '(%'` → должно стать **0**, и в UI не должно
остаться дублей «альбом со скобками» + «альбом без скобок».
⚠️ **Пересоздание контейнера БД НЕ чистит** — `navidrome.db` лежит на диске и монтируется томом
(`/mnt/RED_2TB/docker/navidrome/data:/data`), `down` его не удаляет. Compose-файл не менялся,
бэкап `docker-compose.yml.bak-20260927-052857`. Данные/музыка не пострадали.
⚠️ **`updated_at` у 14 сирот = 10:09–10:23 UTC, `missing=0`** — они считаются живыми записями
(скан их не помечает missing). Причина: album = пара `(name, album_artist)`; теги сменились →
Navidrome **создал новые** альбомы, **старые не удалил** (быстрый скан файлы не перечитывает).
### 🔑 СЛЕДУЮЩИЙ ШАГ (не сделан): перечитать `mtime` файлов → полный скан
Единственный надёжный путь без пароля: **`touch` 306 файлов** (меняет только `mtime`, содержимое
и аудио не трогает) → Navidrome увидит «изменённые» файлы → перечитает теги → сироты уйдут.
Либо через UI Navidrome: `Скан` с галкой **«Full scan»** (пароль `navi_admin` неизвестен —
спрашивать у Alex, не выдумывать; `curl /rest/ping` → `code 40 Wrong username or password`).
**Проверка после:** тот же запрос `LIKE '(%'` → должно стать **0**, в UI не должно быть дублей
«альбом со скобками» + «альбом без скобок».
> 🔴 **ПИТФОЛЛ (важно на будущее): `docker restart` и `docker compose down/up` для Navidrome
> НЕ вызывают полный скан.** В логе всегда `fullScan=false`. Navidrome читает только новые/изменённые
> файлы. Для принудительного перечитывания тегов нужно менять `mtime` файлов или использовать
> UI-скан с `Full scan`. Полный скан на старте — `ND_SCANONSTARTUP` + `ND_SCANONSTARTUP` force
> (**не проверено**, в ENV отсутствует; проверять, если `touch` не поможет).
> 🔴 **ВАЖНО на будущее: `sqlite3` ЕСТЬ на NAS напрямую (`/usr/bin/sqlite3`, 3.40.1)** —
> не нужно `docker exec`. В доке выше есть устаревшее утверждение «`docker exec navidrome sqlite3`»:
@@ -396,6 +415,11 @@ Navidrome помечает missing только при полном рескан
- **`.ndignore` пустой = игнорировать ВСЁ** (проверено строкой в бинаре).
- **`strings <бинарь> | grep ndignore`** — быстрый способ подтвердить фичу без чтения доки.
- **`docker exec navidrome sqlite3`** есть внутри контейнера — БД читается напрямую (в отличие от Jellyfin).
- 🔴 **`docker restart` и `docker compose down/up` НЕ вызывают полный скан Navidrome** — в логе всегда
`fullScan=false` (`duration≈3s`). Смена тегов без смены `mtime` файлов **не подхватывается**.
Для принудительного перечитывания — `touch` файлов либо UI-скан с галкой **Full scan**.
- 🔴 **Пересоздание контейнера не чистит БД** — `navidrome.db` в томе на диске; после `down/up`
данные и число сирот те же. Пересоздавать контейнер ради «чистого скана» бессмысленно.
- **Navidrome не имеет дефолтного логина** — первый вход = форма «Create admin», это не поломка.
---
+21 -10
View File
@@ -4,7 +4,7 @@ created: '2026-09-26'
updated: '2026-09-27'
type: plan
namespace: personal
status: session21-apply-306-done-navidrome-rescan-pending
status: session22-apply-306-done-navidrome-rescan-failed-14-orphans
tags:
- music
- truenas
@@ -85,7 +85,7 @@ CSV: /app/data/apply-plan.csv ← 306 строк
🔴 **Правило: приёмка = чтение тегов с диска по значению, а не `ok=306` из отчёта скрипта.**
Дополнительно проверять **размер файла** (`>100KB`) — он доказывает, что MPEG-поток не тронут (W2).
### ⏳ ОТКРЫТО: NAVidrome — СТАРЫЕ И НОВЫЕ АЛЬБОМЫ СОСУЩЕСТВУЮТ
### ❌ ОТКРЫТО (сессия 22): RESCAN ПРОВЕДЁН — НЕ ПОМОГ, 14 СИРОТ ОСТАЛИСЬ
Navidrome смотрит в **ту же** папку (`/mnt/RED_2TB/storage/Music → /music`), данные
`/mnt/RED_2TB/docker/navidrome/data`, `ND_SCANSCHEDULE=1h`, порт 4533, `https://music.mallexxx.duckdns.org`.
@@ -94,29 +94,40 @@ Navidrome смотрит в **ту же** папку (`/mnt/RED_2TB/storage/Musi
```bash
DB=/mnt/RED_2TB/docker/navidrome/data/navidrome.db
sqlite3 "file:$DB?mode=ro" "SELECT COUNT(*) FROM album WHERE name LIKE '(%';" # → 14
sqlite3 "file:$DB?mode=ro" "SELECT COUNT(*) FROM album WHERE name LIKE '(%';" # → 14 (до И после rescan)
```
| Что | Значение |
|---|---|
| альбомов в БД | 967 |
| со скобками | **14** |
| со скобками | **14** ← число НЕ изменилось от rescan |
| новые значения (`Философские`, `Морские`, `Москва пьёт пиво`, `Retro`, `Владимир Высоцкий`, …) | ✅ появились |
| старые скобочные (`(Философские)`, `(Авария)` ×2, `(Высоцкий)`, …) | ❌ **НЕ удалены** |
**Диагноз:** watcher/плановый скан **добавил** новые альбомы, но **не вычистил старые записи**,
к которым больше нет файлов. Нормальное поведение инкрементального скана — нужен полный rescan.
**Что нужно (не сделано, ждёт решения Alex):**
**Alex: «Navidrome rescan теперь надо» → «Просто контейнер пересоздай». Выполнено — НЕ ПОМОГЛО:**
1. **Рестарт контейнера** — `docker restart navidrome` (полный скан на старте, чистит пропавшие) —
предпочтительный вариант, без пароля;
2. **Плановый скан** — сам раз в час (`ND_SCANSCHEDULE=1h`);
3. Rescan через API требует пароль `navi_admin` — **неизвестен, не выдумывать**
(`curl …/rest/ping` → `code 40 Wrong username or password`).
| # | Способ | Результат |
|---|---|---|
| 1 | `docker restart navidrome` | ❌ лог `fullScan=false` → теги не перечитаны, всё те же **14** |
| 2 | `docker compose down` + `up -d` (пересоздание контейнера) | ❌ лог `fullScan=false`, `duration=3.12s` → снова **14** |
⚠️ **Пересоздание контейнера БД не чистит** — `navidrome.db` в томе на диске, `down` его не удаляет.
Compose не менялся (бэкап `docker-compose.yml.bak-20260927-052857`), данные/музыка целы.
⚠️ Сироты: `updated_at` 10:09–10:23 UTC, `missing=0` — скан их живыми считает.
**🔑 СЛЕДУЮЩИЙ ШАГ (не сделан): `touch` 306 файлов → полный скан.** `touch` меняет только `mtime`,
содержимое/аудио не трогает; Navidrome увидит «изменённые» файлы и перечитает теги. Альтернатива —
UI-скан с галкой **Full scan** (пароль `navi_admin` неизвестен — **не выдумывать**,
`curl …/rest/ping` → `code 40 Wrong username or password`).
Проверка результата — тот же запрос: `LIKE '(%'` должно стать **0**.
🔴 **ПИТФОЛЛ: `docker restart` и `docker compose down/up` для Navidrome НЕ дают полного скана** —
в логе всегда `fullScan=false`. Смена тегов без смены `mtime` не подхватывается.
🔴 **Питфолл-нюанс:** Navidrome при скане **пересчитывает album из тегов**, поэтому у 306 файлов
кроме `TALB` сменился и `TPE2` — в БД это **новые** записи альбомов, а не апдейт старых.
Пока старые не вычищены, в UI видны оба варианта (со скобками и без).