Docker 部署 Navidrome 音乐服务器 🎵☁️

Navidrome 截图

📋 目录导航

🎯 项目简介

Navidrome 是一个开源的音乐流媒体服务器，允许您通过网页浏览器或兼容的客户端应用程序访问您的个人音乐库。它支持多种音频格式，提供美观的界面和强大的音乐管理功能。

✨ 核心特性

特性类别 功能描述 优势
🎧 多格式支持 支持 MP3、AAC、FLAC、OGG、OPUS 等主流音频格式 兼容几乎所有音乐文件类型
🌐 跨平台访问 可通过网页浏览器或移动应用随时随地访问音乐库 随时随地享受个人音乐收藏
🔍 智能搜索 强大的搜索功能，支持按艺术家、专辑、歌曲名等快速查找 快速定位想听的音乐
📱 移动友好 响应式设计，在手机和平板上均有良好体验 移动端使用体验优秀
🎨 主题定制 支持多种界面主题和自定义选项 个性化界面风格
🔄 实时同步 自动检测并同步音乐库中的新增内容 音乐库始终保持最新
📊 播放统计 记录播放历史和个人收听习惯 了解自己的音乐偏好

🐳 一、Docker 部署 Navidrome

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
mkdir -p /mnt/mydisk/home/navidrome && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    restart: unless-stopped
    network_mode: bridge
    environment:
      - ND_SCANNER_EXTRACTOR=ffmpeg
      - ND_ENABLETRANSCODINGCONFIG=true
      - ND_ENABLESHARING=true
      - ND_SCANSCHEDULE=1h
      - ND_SESSIONTIMEOUT=24h
      - ND_LOGLEVEL=info
    ports:
      - 4533:4533
    volumes:
      - ./data:/data
      - /mnt/file/music:/music:ro
EOF

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Navidrome

1. 访问 Web 界面 💻

2. 首次使用步骤 🎯

  1. 打开浏览器访问上述地址
  2. 首次访问需要创建管理员账户（用户名和密码）
  3. 系统会自动扫描配置的音乐目录 /mnt/file/music
  4. 等待音乐库扫描完成（根据音乐数量可能需要几分钟）
  5. 开始享受您的个人音乐流媒体服务！

3. 核心功能速览 🎯

功能 快捷键 / 入口 说明
🎵 播放控制 空格键 播放/暂停当前音乐
⏭️ 下一曲 → 键 播放下一首歌曲
⏮️ 上一曲 ← 键 播放上一首歌曲
🔍 快速搜索 / 键 快速搜索音乐库
📱 移动端应用 Substreamer, play:Sub 支持多种第三方客户端
🌗 主题切换 设置 → 界面 切换明暗主题模式
📻 随机播放 播放控制栏 随机播放音乐库歌曲
🔄 单曲循环 播放控制栏 单曲循环播放模式

🌐 三、Nginx 反向代理配置

访问地址示例：https://navidrome.example.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/navidrome.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name navidrome.example.com;   # 替换为你的域名

    # SSL 证书
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件大小限制
    client_max_body_size 10M;

    location / {
        proxy_pass http://localhost:4533;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Range $http_range;
        proxy_set_header If-Range $http_if_range;
        proxy_redirect off;
        proxy_buffering on;
        proxy_http_version 1.1;
        
        # 超时设置
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
    }

    # 错误页
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航音乐之旅，探索无限旋律

通过本文档，你已经成功使用 Docker 部署了 Navidrome 音乐服务器，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🎵 随时随地 畅听个人音乐收藏，无论身处何地都能享受高品质音乐体验
🎧 完全自主 掌控自己的音乐库，告别平台限制和订阅费用，真正拥有你的音乐
🔐 隐私安全 所有数据本地存储，无需担心第三方收集你的收听习惯和偏好
📱 多端同步 在手机、平板、电脑等各种设备上无缝切换，保持播放进度和歌单同步

音乐是心灵的伴侣，是情绪的良药。愿 Navidrome 成为你忠实的音乐管家，陪伴你在每一个需要旋律的时刻，无论是工作的专注、旅行的惬意还是独处的宁静。

从现在开始，整理收藏，发现音乐——构建你独一无二的私人音乐天地吧！🎶

📌 持续关注：建议留意 Navidrome 官方更新，获取最新功能与优化。
🐛 反馈与支持：使用中遇到问题或有建议，可前往 GitHub Issues 提出。

祝你聆听愉快，音乐常伴！🎉