Music Scraper：
一款轻量级的音乐元数据刮削工具，帮助你自动获取音乐文件的封面、歌词、艺术家等信息。专为 NAS（网络存储）用户设计，支持 Docker 一键部署，通过网页即可在手机/电脑上操作。
功能特性：
- • 🎯 多数据源：支持企鹅、云村、酷系、苹果、开放库等 6 大音乐数据源
- • 🖼️ 智能匹配：基于置信度算法自动选择最佳匹配结果
- • 📱 移动端适配：赛博朋克风格 UI，支持手机/平板访问
- • 🚀 一键部署：Docker 镜像开箱即用，专为 NAS 优化
- • 📦 批量处理：支持整个文件夹自动批量刮削
- • 🎵 多格式支持：MP3、FLAC、M4A、OGG、WAV、WMA 等
- • 📝 歌词获取：自动下载歌词并保存为 LRC 文件
- • 🎤 内嵌歌词：支持将歌词直接写入音频文件元数据（MP3/FLAC/M4A/OGG/WMA/WAV/AIFF/APE/WavPack 等）
- • 🔄 多源互补：首选源缺少数据时，自动从其他源补充
- • 🛡️ 广告过滤：自动识别并清理音乐标签中的广告内容，保持元数据干净整洁（v1.0.5 新增）
- • ⚡ 熔断保护：数据源连续失败后自动熔断，避免无效请求，提升稳定性（v1.0.8 新增）
- • 🎨 双主题支持：暗夜/樱两种主题风格，支持一键切换（v1.0.9 新增）
- • ✏️ 手动编辑：直接编辑元数据，支持封面上传/更换（v1.0.9 新增）
- • 🎤 双语歌词：自动合并原文和翻译歌词（v1.0.9 新增）
安装
Docker Compose
services:
music-scraper:
image: minzgo/music-scraper:latest
container_name: music-scraper
ports:
- 7301:7301
environment:
- TZ=Asia/Shanghai
volumes:
- ./music:/app/music
- ./data:/app/data
restart: unless-stopped
参数说明（更多参数建议去看文档）
:::TZ（环境变量，可选）：设置时区
/app/music（路径）：挂载音乐文件夹
/app/data（路径）：保存刮削数据和配置
:::
使用
浏览器中输入 http://NAS的IP:7301 就能看到界面
设置登录密码，点击“开始使用”
TIP：界面是针对移动网页端适配的，不过为了截图能看得清晰，还是直接用 PC 网页端作为展示
进入后能看到有手动和自动刮削两种刮削模式
先看看设置，配置刮削偏好
TIP：有 3 天免费试用全功能（过期了也可以继续用，只是一些功能不行）
点击打开“自动检测”（里面默认就已经设置好了，不过可以自定义修改）
有需要的可以配置多个监测路径和扫描间隔这些参数
数据源支持挺多的，基本上前面两个就已经覆盖全部了，也可以多勾选几个
重点看下面写入字段，我是都勾选上的（歌词还是内置比较好，只有一个音频文件整理起来方便一些）
最下面的去广告功能也可以打开（如果之前文件刮削内容比较乱，可以关闭跳过已有信息，重新再整理一次）
没有问题就启用监测
点击“开始扫描”，这样就配置好自动监测了
回到首页，点击“自动刮削”进行设置（不知道为什么，自动检测和刮削两边都要设置，希望后面可以简化一下）
和前面设置是一样的，就不展开说了
来到存放音乐的映射路径，建议先放几首音乐测试，后面没问题再来大批量刮削
回到页面，已经自动刮削好了
点开进入查看，基本信息都有（歌词的话，识别的是外部文件所以没检测到）
TIP：如果没有识别成功，也能手动进行刮削处理（这里就不展开了，操作起来都很简单）
这是没刮削前的效果（自带是有一些信息，但是没有封面和歌词）
刮削后效果，体验还是很明显的
总结
之前我自己也弄过几次音乐刮削，操作还是比较繁琐的。不过，目前用 Music Scraper 这款音乐刮削器还是挺方便的，配置好以后全自动刮削，一直挂着运行就行。
综合推荐：⭐⭐⭐⭐（是真的不错，值得推荐部署）
使用体验：⭐⭐⭐（设置简单，全自动刮削）
部署难易：⭐⭐（简单）︎
︎
