影音与下载

Navidrome:群晖部署与音流客户端连接

  • 0 次阅读
  • 0 条评论
文章摘要

本地音乐工作流可以拆成素材获取、标签整理、音乐服务器和客户端四层。各工具共用清晰的目录约定,比把全部环节塞进一个容器更容易维护。 下载暂存区负责接收文件,整理工具补齐标签和封面,服务器建立索引,手机与电脑客户端负责播放。每层只做自己的工作,文件路径和权限则贯穿整个流程。 适合希望多端使用同一音乐库的家庭。先确定正式库的目录和标签规范,再选择服务端与客户端,能够减少后期更换播放器时重复整理文件。

项目介绍

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

补充:部署与使用

安装与使用步骤

  1. 把已拥有使用权的音频统一归档,先确定艺术家、专辑与曲目的命名方式,下载目录和正式音乐库分开。
  2. 用 lyricFlow 等工具补充歌词或标签,先处理副本,再让 Navidrome 或道理鱼等服务器扫描正式库。
  3. 为家人创建独立账号,在手机播放器配置服务器地址,检查封面、歌词、播放与进度。
  4. 逐层检查失败点:文件是否存在、标签是否正确、服务端是否入库、客户端是否获得访问权限。

以 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 扫描该专辑。中文乱码先分清文件名编码与标签编码,不直接批量转换全库。

扫描后出现重复专辑时,先比较专辑歌手、专辑名称和光盘号;客户端看不到修改则检查扫描状态与客户端缓存。封面、歌词和播放列表不能代替原始音频备份。

参考资料