casjaysdevdocker/navidrome

navidrome Docker镜像文档

镜像概述

本镜像为navidrome音乐服务器提供容器化部署方案。navidrome是一款开源音乐服务器，支持多种音频格式，提供直观的Web管理界面和API，可用于搭建个人或家庭音乐库，实现音乐文件的集中管理和跨设备访问。

核心功能

• Web管理界面：通过浏览器访问音乐库，支持音乐播放、专辑管理、播放列表创建等功能
• 音乐文件处理：自动索引音乐文件，支持元数据识别和整理
• 多客户端支持：兼容Subsonic API，可与多种音乐客户端（如DSub、Sonixd等）配合使用
• 灵活配置：支持自定义配置参数，适应不同使用场景需求
• 数据持久化：通过卷挂载确保音乐文件、配置和数据的持久化存储

使用场景

• 个人音乐库搭建：集中管理本地音乐文件，实现跨设备访问
• 家庭音乐共享：在家庭网络中共享音乐资源
• 远程音乐访问：通过网络远程访问个人音乐库
• 轻量级音乐服务器：替代传统本地音乐播放器，提供更灵活的访问方式

使用方法

前提条件

• 已安装Docker和Docker Compose（如需使用compose方式）
• 准备音乐文件目录（如$HOME/Music）

通过命令行运行

shell
docker pull casjaysdevdocker/navidrome:latest && \
docker run -d \
--restart always \
--name casjaysdevdocker-navidrome \
--hostname casjaysdev-navidrome \
-e TZ=${TIMEZONE:-America/New_York} \
-v $HOME/Music:/data/music \
-v $HOME/.local/share/docker/storage/navidrome/data:/data:z \
-v $HOME/.local/share/docker/storage/navidrome/config:/config:z \
-p 19020:80 \
-p 6600:6600 \
casjaysdevdocker/navidrome:latest

参数说明：

• --restart always：容器退出时自动重启
• --name：指定容器名称
• --hostname：设置容器主机名
• -e TZ：设置时区（默认：America/New_York，可替换为如Asia/Shanghai）
• -v $HOME/Music:/data/music：挂载本地音乐目录到容器内
• -v .../data:/data:z：挂载数据存储目录（用于索引、缓存等）
• -v .../config:/config:z：挂载配置文件目录
• -p 19020:80：映射Web界面端口（主机端口:容器端口）
• -p 6600:6600：映射音乐服务端口（用于客户端连接）

通过Docker Compose运行

创建docker-compose.yml文件：

yaml
version: "2"
services:
  navidrome:
    image: casjaysdevdocker/navidrome
    container_name: navidrome
    environment:
      - TZ=America/New_York  # 时区设置，可修改为实际时区
      - HOSTNAME=casjaysdev-navidrome  # 容器主机名
    volumes:
      - $HOME/Music:/data/music:z  # 本地音乐目录
      - $HOME/.local/share/docker/storage/navidrome/data:/data:z  # 数据存储目录
      - $HOME/.local/share/docker/storage/navidrome/config:/config:z  # 配置文件目录
    ports:
      - 19020:80  # Web界面访问端口
      - 6600:6600  # 音乐服务端口
    restart: always  # 自动重启策略

启动容器：

shell
docker-compose up -d

访问与使用

容器启动后，通过浏览器访问 http://<主机IP>:19020 即可打开navidrome Web界面，首次使用需创建管理员账户。之后可添加音乐文件到挂载的音乐目录，系统会自动索引并展示音乐库。