搜索文章 Ctrl K

Music-Tag-Web

Setang 174 阅读 信息分享

用 Music Tag Web 给 NAS 音乐批量刮削歌词——小白向完全教程

适用版本：music-tag-web（GitHub: xhongc/music-tag-web）
部署方式：Docker / Docker Compose
难度：⭐⭐☆☆☆

前言

很多人把音乐存在 NAS 上，用 Navidrome、Jellyfin 这类媒体服务器来播放，但下载回来的音乐文件往往标签残缺、歌词全无，听歌体验大打折扣。

Music Tag Web 就是专门解决这个问题的——它是一款运行在 Web 端的音乐元数据编辑器，可以直接部署在服务器/NAS 上，远程对音乐文件进行批量刮削，支持封面、歌词、标题、艺术家、专辑等信息的自动获取和写入。

支持格式：FLAC, APE, WAV, AIFF, WV, TTA, MP3, M4A, OGG, MPC, OPUS, WMA, DSF, MP4 等主流无损/有损格式，基本上你能遇到的都覆盖了。

一、部署：用 Docker 跑起来

方式一：docker run 一行命令

docker run -d \
  -p 8002:8002 \
  -v /your/music:/app/media \
  -v /your/config:/app/data \
  --restart=always \
  --name music-tag-web \
  xhongc/music_tag_web:latest

把 /your/music 替换成你的音乐文件夹路径，/your/config 替换成你想存放配置的目录。

方式二：docker-compose（推荐）

新建 docker-compose.yml，写入以下内容：

version: '3'
services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - "8002:8002"
    volumes:
      - /your/music:/app/media:rw
      - /your/config:/app/data
    restart: unless-stopped

然后在同目录执行：

docker compose up -d

访问与初始化

部署成功后，浏览器访问：

http://你的IP:8002

默认账号密码均为 admin，首次登录后请立即修改密码（右上角用户设置）。

二、进入操作台，加载音乐文件

登录后，点击左侧菜单的「操作台」，你会看到挂载目录下的音乐文件列表。

界面显示的就是 /app/media（即你挂载的音乐文件夹）里的所有音频文件。

💡 如果文件没有出现，检查 docker 挂载路径是否正确，以及宿主机目录有无读写权限。

三、配置刮削源（关键步骤）

在操作台，点击任意一首歌曲名，界面会变成三屏模式：

  • 左侧：文件当前标签信息

  • 中间：刮削操作区

  • 右侧：搜索结果预览

点击中间区域的**「设置」图标**（齿轮），可以配置刮削来源的优先级。支持的来源包括：

  • 网易云音乐

  • QQ 音乐

  • 酷狗音乐

  • 咪咕音乐

  • 酷我音乐

建议同时勾选多个来源，系统会按优先级依次尝试，提高命中率。

四、手动刮削单首歌曲

配置好来源后，对单首歌曲操作非常简单：

  1. 在操作台点击歌曲名，进入三屏编辑界面

  2. 点击「标题」字段右侧的搜索箭头

  3. 系统会根据当前标题/艺术家全网搜索，在右侧展示候选结果

  4. 找到正确的那首，点击结果前面的小箭头，信息就会自动填入左侧

  5. 确认歌词、封面等信息无误后，点击「保存」

这个流程一首歌基本 30 秒搞定，歌词、封面、专辑信息一次性全部写入文件。

五、批量自动刮削（核心功能）

手动一首首刮太慢，批量刮削才是重点。

操作步骤

  1. 回到操作台，用顶部的全选框（或 Ctrl+A）勾选所有文件

  2. 点击上方工具栏的「自动刮削」按钮

  3. 在弹出的配置窗口中，勾选你想刮削的字段（标题、艺术家、专辑、歌词、封面等）

  4. 确认后点击「开始」

系统会在后台逐一处理，可以在「任务中心」查看实时进度和刮削日志。

⚠️ 注意：批量刮削是根据文件现有的标题和艺术家信息去匹配的。文件名/标签越规范，命中率越高。如果你的文件名一团糟（如 track01.mp3），建议先手动补全基础标签再批量刮削。

写在最后

Music Tag Web 是 NAS 音乐玩家的利器，配合 Navidrome / Jellyfin 使用效果极好。整个刮削流程一旦跑通，几千首音乐的标签和歌词基本可以一键搞定，省去大量手动整理的时间。

项目地址：https://github.com/xhongc/music-tag-web
官方文档：https://xiers-organization.gitbook.io/music-tag-web-v2

觉得有用的话，去 GitHub 给作者点个 Star ⭐ 吧！