swimminghao/navidrome

Navidrome Docker镜像文档

概述

Navidrome是一个轻量级、开源的自托管音乐服务器，旨在提供个人音乐库的流媒体服务。它支持多种音频格式，具备直观的Web界面和跨平台客户端支持，允许用户通过网络随时随地访问自己的音乐收藏。

核心功能与特性

• 多格式支持：兼容MP3、FLAC、OGG、AAC等多种音频格式
• Web界面：提供响应式设计的Web管理界面，支持音乐浏览、搜索和播放
• 移动客户端：支持Subsonic API，可与多种音乐客户端（如DSub、Ultrasonic等）配合使用
• 用户管理：支持多用户账户，可设置不同权限
• 元数据管理：自动识别和组织音乐元数据，支持专辑封面、艺术家信息等
• 低资源占用：轻量级设计，适合在个人服务器或NAS上运行

使用场景

• 个人音乐库的集中管理与远程访问
• 家庭网络内的音乐共享服务
• 替代商业音乐流媒体服务，保护数据隐私
• 小型办公室或社区的音乐服务部署

使用方法

基本部署（Docker Run）

使用以下命令快速部署Navidrome容器：

bash
docker run -d \
  --name navidrome \
  --restart=unless-stopped \
  --user $(id -u):$(id -g) \
  -v /path/to/your/music:/music \
  -v /path/to/your/data:/data \
  -p 4533:4533 \
  -e ND_LOGLEVEL=info \
  deluan/navidrome:latest

参数说明：

• --name navidrome：指定容器名称为navidrome
• --restart=unless-stopped：容器退出时自动重启（除非手动停止）
• --user $(id -u):$(id -g)：使用当前用户ID和组ID运行容器，避免权限问题
• -v /path/to/your/music:/music：挂载本地音乐目录到容器内的/music
• -v /path/to/your/data:/data：挂载数据目录（用于存储配置、数据库等）
• -p 4533:4533：映射容器端口4533到主机，用于Web访问
• -e ND_LOGLEVEL=info：设置日志级别为info（可选值：debug, info, warn, error）

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    restart: unless-stopped
    user: "${UID}:${GID}"
    volumes:
      - /path/to/your/music:/music
      - /path/to/your/data:/data
    ports:
      - "4533:4533"
    environment:
      - ND_LOGLEVEL=info
      # 可选环境变量
      # - ND_BASEURL=/navidrome  # 设置访问基础路径（如反向代理时使用）
      # - ND_SCANINTERVAL=1h    # 音乐库扫描间隔（默认1小时）
      # - ND_SESSIONTIMEOUT=24h # 会话超时时间

运行命令：

bash
# 设置当前用户ID和组ID
export UID=$(id -u)
export GID=$(id -g)
# 启动服务
docker-compose up -d

访问服务

部署完成后，通过浏览器访问 http://<主机IP>:4533，首次访问需创建管理员账户。

配置参数

常用环境变量配置：

注意事项

• 确保挂载的音乐目录具有读权限，数据目录具有读写权限
• 首次启动时会扫描音乐库，大型音乐库可能需要较长时间
• 如需通过互联网访问，建议配置HTTPS和反向代理（如Nginx）