Docker 部署 Music-Tag 音乐元数据刮削器 🎵

📋 目录导航

🎯 项目简介

Music-Tag 是一个基于 Web 的音乐元数据刮削工具，能够自动为您的音乐文件添加和编辑元数据信息，包括专辑封面、艺术家信息、专辑名称、曲目编号等。通过 Docker 部署，您可以轻松管理和美化您的音乐库。

✨ 核心特性

特性类别 功能描述 优势
🏷️ 自动元数据刮削 从多种在线资源自动获取音乐元数据 支持多个数据源，信息准确丰富
🎨 专辑封面下载 自动查找并添加高质量的专辑封面 提升音乐库视觉体验
🌐 Web 界面 直观的浏览器操作界面 无需命令行知识，操作简单
🔄 批量处理 支持批量处理整个音乐库或特定文件夹 高效管理大量音乐文件
📁 多格式支持 支持 MP3、FLAC、AAC、OGG 等常见音频格式 兼容主流音频格式
🔍 智能匹配 基于文件名和现有元数据智能匹配正确信息 提高匹配准确率
💾 配置持久化 所有设置和进度自动保存 避免重复配置，使用更便捷

🐳 一、Docker 部署 Music-Tag

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

1
2
3
4
5
6
7
8
9
10
11
12
13
mkdir -p /mnt/mydisk/home/music-tag && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag
    restart: unless-stopped
    ports:
      - "8001:8001"
    volumes:
      - ./music:/app/media:rw
      - ./config:/app/data
EOF

🔐 默认登录凭据：用户名 admin / 密码 admin，首次登录后请立即修改密码！

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

1
docker-compose up -d

🚀 二、使用 Music-Tag

1. 访问 Web 界面 💻

  • 本地访问: http://localhost:8001
  • 域名访问: https://music-tag.example.com（配置反向代理后）

2. 首次使用步骤 🎯

  1. 访问上述地址
  2. 使用默认凭据登录（admin/admin）
  3. 立即修改默认密码
  4. 配置音乐目录路径（默认为 /app/media）
  5. 开始扫描和整理音乐元数据

3. 最佳实践 💡

实践建议 说明 好处
📦 先备份 在对大量音乐文件进行修改前，建议先备份原始文件 防止数据丢失，可回滚操作
🔢 分批处理 先处理少量文件测试效果，再批量处理整个库 避免大规模错误操作
👀 手动审核 自动刮削后，手动检查重要元数据确保准确性 保证元数据质量
🔄 定期更新 保持容器镜像更新以获得最新功能和数据源 获得更好的刮削效果

🌐 三、Nginx 反向代理配置

访问地址示例：https://music-tag.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
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/music-tag.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name music-tag.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:8001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        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
# 进入项目目录
cd /mnt/mydisk/home/music-tag

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

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

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

# 完整升级流程
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
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop music-tag      # 停止容器
docker start music-tag     # 启动容器  
docker restart music-tag   # 重启容器

# 删除容器
docker rm music-tag        # 删除已停止容器
docker rm -f music-tag     # 强制删除运行中容器

# 进入容器Shell
docker exec -it music-tag bash    # 使用bash进入容器
docker exec -it music-tag sh      # 使用sh进入容器

# 查看容器详情和资源使用
docker inspect music-tag     # 查看详细配置
docker stats music-tag       # 实时资源监控

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

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🎵 启航音乐，完善收藏

通过本文档，你已经成功使用 Docker 部署了 Music-Tag 音乐元数据刮削器，并通过 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🎧 智能管理 自动完善音乐文件的元数据和专辑封面，打造整洁规范的音乐库
🌍 随时随地 通过网页界面轻松整理音乐收藏，无需安装复杂软件
⚡ 高效批处理 快速整理大量音乐文件，节省手动编辑的时间和精力
🎨 视觉升级 为音乐库添加高质量封面艺术，提升浏览和播放体验

音乐不仅是听觉的享受，更是情感的寄托。愿 Music-Tag 成为你音乐管理的好帮手，让你的每一首收藏都完整、规范、美观。

从现在开始，完善你的音乐库，让每一首歌曲都拥有完整的故事！🎶

📌 持续迭代：建议关注 Music-Tag 官方更新，及时获取新功能与数据源优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你整理愉快，音乐有成！🎉