Navidrome 群晖 Container Manager 部署教程

简介

Navidrome 是开源音乐服务器，支持读取本地音乐文件，网页端播放，支持简体中文界面，可配合各类音乐客户端接入。

前置准备

  1. 在文件管理器新建目录：/volume1/docker/navidrome/data
  2. 确认音乐存放路径：/volume1/music

docker-compose.yml

services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    restart: unless-stopped
    ports:
      - "4533:4533"
    volumes:
      - ./data:/data
      - /volume1/music:/music:ro
    environment:
      - TZ=Asia/Shanghai
      - ND_DEFAULTLANGUAGE=zh-Hans

部署步骤

  1. 打开群晖 Container Manager，新建项目
  2. 项目路径填写 /volume1/docker/navidrome
  3. 将上述内容粘贴到 docker-compose.yml
  4. 启动项目，等待镜像拉取完成
  5. 浏览器访问 http://NAS内网IP:4533
  6. 首次访问，注册管理员账号密码，进入系统

功能说明

  1. 内置简体中文界面，部署完成默认中文
  2. 自动扫描 /volume1/music 目录内音乐文件，支持 MP3、FLAC、APE 等主流音频格式
  3. 支持专辑、艺术家、歌曲分类，收藏、评分、播放列表管理
  4. 兼容 Subsonic/OpenSubsonic 协议，支持移动端APP远程播放

关键说明

  1. ./data：存放程序数据库、配置、缓存，备份该目录即可保留全部配置与收藏信息
  2. /volume1/music:/music:ro：音乐目录只读挂载，防止容器修改源文件
  3. ND_DEFAULTLANGUAGE=zh-Hans：设置系统默认简体中文
  4. 端口 4533 为网页访问端口，可按需修改冒号左侧宿主机端口

常见问题

  1. 容器启动失败：检查宿主机目录是否存在，目录读写权限
  2. 看不到音乐：确认挂载路径正确，进入Navidrome设置手动触发扫描
  3. 中文乱码：确认环境变量 ND_DEFAULTLANGUAGE=zh-Hans，音乐文件元数据编码正常

对比 Audio Station

Navidrome 元数据识别能力更强，对无损音乐、中文歌曲兼容性更好，跨平台客户端丰富；Audio Station 仅适配群晖生态，移动端支持较弱

移动端客户端

Navidrome 无官方APP，基于 OpenSubsonic 协议，可使用第三方客户端连接：

  • Android：Ultrasonic（免费开源）、Symfonium（全功能付费）、DSub
  • iOS：Substreamer、Amplitude

连接方法

  1. 客户端填写服务地址：http://NAS内网IP:4533
  2. 账号密码为Navidrome网页端注册账号
  3. 内网可直接播放，外网访问需配置反向代理或端口映射

网页播放与移动端客户端对比

手机网页端可以直接播放，适合内网临时试听。

网页端局限

  • 手机锁屏或切换后台，音乐容易被系统中断
  • 不支持离线缓存，必须保持网络连接
  • 蓝牙耳机、锁屏媒体控件经常失效
  • 无无缝播放、均衡器、同步歌词等高级音频功能
  • 页面刷新后播放队列容易丢失

第三方客户端优势

  • 后台稳定播放，锁屏持续播放音乐
  • 支持歌曲离线下载，无网络环境收听
  • 系统媒体深度集成：锁屏控件、蓝牙耳机切歌、车载CarPlay/Android Auto
  • 音频增强：无缝播放、交叉淡入、均衡器、同步歌词
  • 可保存多组服务器地址，内网外网自动切换

使用建议

内网居家临时试听，直接使用网页；通勤、车载、离线收听场景，推荐使用客户端。