项目介绍
Navidrome 用于扫描本地音乐目录并向兼容客户端提供曲库服务。下面介绍群晖部署、目录准备、首次扫描和音流客户端连接。歌曲标签和封面应先整理好,再让服务器建立索引。
services:
navidrome:
image: deluan/navidrome:latest
container_name: navidrome
user: 0:0
network_mode: host
restart: unless-stopped
environment:
ND_SCANSCHEDULE: 1h
ND_LOGLEVEL: info
ND_SESSIONTIMEOUT: 24h
ND_BASEURL: ""
ND_ENABLETRANSCODINGCONFIG: "true"
ND_TRANSCODINGCACHESIZE: "4000M"
ND_IMAGECACHESIZE: "1000M"
volumes:
- /volume1/docker/navidrome/data:/data
- /volume1/media/music:/music客户端用音流
端口4533
补充:部署与使用
安装与使用步骤
- 把已拥有使用权的音频统一归档,先确定艺术家、专辑与曲目的命名方式,下载目录和正式音乐库分开。
- 用 lyricFlow 等工具补充歌词或标签,先处理副本,再让 Navidrome 或道理鱼等服务器扫描正式库。
- 为家人创建独立账号,在手机播放器配置服务器地址,检查封面、歌词、播放与进度。
- 逐层检查失败点:文件是否存在、标签是否正确、服务端是否入库、客户端是否获得访问权限。
以 Navidrome 建立只读音乐库
下面选用 Navidrome 作为本地曲库服务示例。它不负责补齐所有缺失歌词或原始音频,先把音乐文件和标签整理好。按下方命令创建 data 目录,运行身份直接使用 0:0。打开 http://NAS_IP:4533 初始化首个账号,音乐目录在容器内为 /music。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/navidrome/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/navidrome /volume1/docker/navidrome/data /volume1/music
cd /volume1/docker/navidrome
HALO_PREPARE
cd /volume1/docker/navidrome
本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。
services:
navidrome:
image: navidrome/navidrome:latest
restart: unless-stopped
user: "0:0"
ports:
- "4533:4533"
volumes:
- /volume1/docker/navidrome/data:/data
- /volume1/music:/music:ro
配置依据:Navidrome 官方 Docker 文档。测试顺序是扫描一张专辑、网页播放、客户端连接,再导入整个曲库。备份原始音乐与 /data 数据,两者用途不同。
首次使用与操作检查
先以一张专辑跑通全流程:复制音频、核对标签、扫描入库,再从手机播放。确认歌曲顺序、封面、歌词和权限后,再逐批迁移剩余曲库。
不要让多个整理工具同时改写正式库。发现缺歌时先查文件是否存在及格式是否支持,再看服务器扫描记录,最后检查客户端过滤条件与账号权限。
配置与常见问题
- simple_sq_music_plus、lyricFlow、道理鱼和 Navidrome 各自承担不同环节,不能互相套用挂载路径。
- 自建播放器不会改变音乐平台的账号和内容授权范围。
更新与备份
正式音乐库、服务端数据库和播放列表分别备份,刮削前保留可恢复副本。
标签修改与曲库扫描的衔接
Music Tag Web 等标签工具适合处理目录里的标题、专辑、专辑歌手、曲目号、光盘号、封面和歌词;Navidrome 等音乐服务负责扫描、索引与客户端访问。两者分开升级,避免同时改写同一文件。
先复制一张专辑到测试目录,保存原始标签,再让编辑工具处理。保存后用另一个播放器读取,确认专辑歌手与曲目顺序,再让 Navidrome 扫描该专辑。中文乱码先分清文件名编码与标签编码,不直接批量转换全库。
扫描后出现重复专辑时,先比较专辑歌手、专辑名称和光盘号;客户端看不到修改则检查扫描状态与客户端缓存。封面、歌词和播放列表不能代替原始音频备份。