# Debian + Docker部署music-tag-web + 刮削全流程
## 一、环境准备（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的时候有些会出现刮削不出来的情况,清理后又快又干净.希望这篇文章对你有用!