Debian + Docker部署music-tag-web + 刮削全流程

作者Hayashi

一、环境准备（Debian）

1. 更新系统并安装依赖

运行

sudo apt update
sudo apt upgrade -y
sudo apt install -y docker.io docker-compose

2. 启动 Docker 并设置开机自启

运行

sudo systemctl enable docker
sudo systemctl start docker

二、Docker 部署 music-tag-web

1. 创建目录

运行

#创建 V2 配置目录（如果不存在）
mkdir -p /mnt/nvme/music-tag-web-v2/config
#设置权限（按需）
chmod 755 /mnt/nvme/music-tag-web-v2/config

2. 拉取镜像和运行

运行

docker run -d \
  --name=music-tag-web \
  -p 192.168.2.1:8001:8001 \ #这里的IP可以设置成你自己的服务器地址,建议设置内网IP
  -v /mnt/nvme/music:/app/media:rw \
  -v /mnt/nvme/music-tag-web/config:/app/data \
  --restart unless-stopped \
  xhongc/music_tag_web:latest

3. 访问

浏览器打开：
http://192.168.2.1:8001
默认账号密码：admin / admin（登录后务必修改）

三、下载的音频文件Tag清理

1. 安装 Mp3tag（免费）

下载地址:

https://www.mp3tag.de/en/download.html

2. 处理音频文件的tag

(1) 关闭并删除 ID3v1（核心设置）
打开 Mp3tag → 菜单：工具 → 选项 → 标签 → Mpeg
按下面设置：
Read（读取）
✅ ID3v2
❌ ID3v1
❌ APE
Write（写入）
✅ ID3v2.4 UTF-8
❌ ID3v1
❌ APE
Remove（删除）
✅ ID3v1（必须勾！）
✅ ID3v2
❌ APE
确定。

(2) 批量清除所有旧标签
导入歌曲目录
Ctrl+A 全选
右键 → 移除标签 → 所有标签
→ 左边标签区全部清空

(3) 从文件名重建基础标签（避免无信息刮不到）
文件名格式建议：艺术家 – 标题.mp3
保持全选
菜单：转换 → 文件名 → 标签
格式：

%artist% - %title%

确定 → 自动回填艺术家、标题
(4) 最终保存
Ctrl+S
此时 “标签” 列只显示 ID3v2.4，无 v1。

3. 回传清洗后的文件到 Debian

把本地处理好的 MP3 上传回 Debian 的 ~/music-tag/media 目录，覆盖旧文件。

四、music-tag-web 刮削最佳实践

1. 首次设置

登录后进入 设置
媒体路径填写：/app/media
保存并扫描
(1) 刮削源选择（重点）
英文曲库：只留 MusicBrainz + Discogs（关闭酷狗 / QQ 音乐，避免乱码）
华语曲库：加 豆瓣
注:这里实际全选也没关系
(2) 批量刮削步骤
勾选要处理的文件夹 / 歌曲（建议每次 200 首以内，防限流）
左侧点 自动刮削
模式选：标准模式（平衡准确率与速度）
勾选：覆盖空标签、下载封面、下载歌词
保存 → 开始刮削
(3)刮削后检查
查看操作记录，失败项单独处理
成功歌曲：标签、专辑、封面、歌词齐全

五、常见问题与避坑

为什么关了 ID3v1 还显示 v1？
只关 “写入” 没用，必须勾选 Remove ID3v1 + 重新保存
旧文件残留 v1 区块，要 “移除所有标签” 再重建
刮削乱码 / 匹配错？
根源：双标签（v1+v2）、酷狗脏字符、编码混乱
解决：必须用 Mp3tag 清洗干净再刮
中文文件名乱码？
Debian 确保 UTF-8：
运行

sudo apt install locales
sudo locale-gen zh_CN.UTF-8

结语

以上方法就是我使用Music-Tag-Web过程中的心得,不清理Tag的时候有些会出现刮削不出来的情况,清理后又快又干净.希望这篇文章对你有用!

类似文章