专为 NAS 用户打造的音乐元数据刮削工具
自动获取音乐文件的封面、歌词、艺术家等信息，支持 6 大音乐数据源，智能匹配最佳结果。
# 推荐：自动选择合适架构
docker pull minzgo/music-scraper:latest
# 或指定架构
# x86 架构（绿联云、威联通、部分群晖）
docker pull minzgo/music-scraper:2.1.5-amd64
# ARM 架构（部分群晖、树莓派）
docker pull minzgo/music-scraper:2.1.5-arm64
基础部署（推荐挂载数据目录）：
docker run -d \
--name music-scraper \
-p 7301:7301 \
-v /你的音乐目录:/app/music \
-v /数据目录:/app/data \
-e TZ=Asia/Shanghai \
--restart unless-stopped \
minzgo/music-scraper:latest
💡 如需基于硬件信息生成更稳定的设备码，可在
docker run中额外添加--privileged。
基础配置：
version: '3'
services:
music-scraper:
image: minzgo/music-scraper:latest
container_name: music-scraper
ports:
- "7301:7301"
volumes:
- /你的音乐目录:/app/music
- ./data:/app/data
environment:
- TZ=Asia/Shanghai
restart: unless-stopped
刮削器 + 工具箱联合部署（完整功能）：
version: '3'
services:
music-scraper:
image: minzgo/music-scraper:latest
container_name: music-scraper
privileged: true
ports:
- "7301:7301"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- /你的音乐目录:/app/music # 需修改：改成你的实际音乐目录，例如 /volume2/音乐:/app/music
- ./scraper-data:/app/data
environment:
- TZ=Asia/Shanghai
- TOOLBOX_URL=http://music-toolbox:7305
restart: unless-stopped
depends_on:
- music-toolbox
music-toolbox:
image: minzgo/music-toolbox:latest
container_name: music-toolbox
ports:
- "7305:7305"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- /你的存储卷:/app/source:rw # 需修改：改成音乐目录和输出目录的共同父目录，例如 /volume2:/app/source:rw
- ./toolbox-data:/app/data
environment:
- TZ=Asia/Shanghai
- SCRAPER_URL=http://music-scraper:7301
restart: unless-stopped
💡 工具箱说明：工具箱是刮削器的配套功能，提供硬链接整理、自动分类等功能。刮削完成后可自动触发硬链接整理。 ⚠️ 联合部署时
TOOLBOX_URL/SCRAPER_URL必须使用 Docker 服务名；工具箱建议挂载音乐目录的父目录到/app/source，确保源目录和输出目录在同一挂载点下。
浏览器打开 http://你的IP:7301 即可使用！
| 端口 | 说明 |
|---|---|
7301 | 刮削器 Web 服务端口 |
7305 | 工具箱 Web 服务端口（联合部署时） |
| 路径 | 说明 | 适用服务 |
|---|---|---|
/app/music | 音乐文件目录（必需） | 刮削器 |
/app/data | 数据存储目录（配置、数据库、缓存） | 刮削器/工具箱 |
/app/source | 数据源根目录（包含音乐和输出目录） | 工具箱 |
/var/run/docker.sock | Docker socket（路径自动转换） | 刮削器/工具箱（联合部署时） |
| 变量 | 默认值 | 说明 | 适用服务 |
|---|---|---|---|
PORT | 7301 | 服务端口 | 刮削器 |
TZ | UTC | 时区设置 | 刮削器/工具箱 |
TOOLBOX_URL | http://localhost:7305 | 工具箱内部通信地址（后端间通信，Docker 网络内使用服务名） | 刮削器 |
TOOLBOX_EXTERNAL_URL | 自动推断 | 工具箱外部访问地址（浏览器跳转用，反向代理场景必填） | 刮削器 |
SCRAPER_URL | 自动发现 | 刮削器地址（用于授权验证，Docker 网络内使用服务名） | 工具箱 |
SCRAPE_WORKERS | 8 | 刮削并发数（1-16，可在设置界面调整） | 刮削器 |
⚠️ Docker Compose 中
TOOLBOX_URL和SCRAPER_URL不要写localhost，容器内的localhost指向容器自身。
| 标签 | 架构 | 适用设备 |
|---|---|---|
latest | 多架构 | 推荐，自动选择合适架构 |
2.1.5 | 多架构 | 指定版本，自动选择架构 |
2.1.5-amd64 | x86_64 | 绿联云、威联通、群晖(Intel)、PC/服务器 |
2.1.5-arm64 | ARM64 | 群晖(ARM)、树莓派 4、Apple Silicon |
💡 推荐使用：直接使用
latest，Docker 会自动选择适合您设备的架构
💡 Hi-Res 格式因技术限制暂不支持写入，但可以读取并显示现有元数据
| 数据源 | 特点 |
|---|---|
| 企鹅音乐 | 华语覆盖全，封面高清 |
| 云村音乐 | 华语覆盖好，有歌词 |
| 酷狗音乐 | 歌词资源丰富 |
| 酷沃音乐 | 曲库较全 |
| 苹果音乐 | 欧美日韩覆盖好 |
| 开放数据库 | 数据规范 |
遇到问题或有建议？欢迎加入用户交流群，获取最新版本、提需求、技术交流！
🐛 Bug 修复
🔧 优化改进
✨ 新功能
artist-title）分类模式，歌曲文件直接放在歌手目录，支持多歌手合并/分开处理🔧 优化改进
SCRAPER_TOOLBOX_LOG_TOKEN 服务令牌鉴权，dev.sh 与 Docker Compose 已补充该配置🐛 Bug 修复
.mp4、.asf 等视频或混合容器，避免同名 MV 与歌曲被误判为重复文件🔧 优化改进
/images/group-qrcode.png 引用，避免扩展名、MIME 与真实编码不一致📦 镜像发布
2.1.3，示例镜像标签已更新为 v2.1.3✨ 新功能
A-Z、0-9、其他目录，适合按歌名或文件名浏览整理结果🔧 优化改进
📦 镜像发布
2.1.2 / latest 多架构镜像，均支持 linux/amd64 与 linux/arm64🐛 Bug 修复
u.y.qq.com/cgi-bin/musicu.fcg，POST + JSON 协议），恢复手动刮削、自动刮削、双语歌词等所有依赖该数据源的链路✨ 新功能
🐛 Bug 修复
🔧 优化改进
历史版本更新记录请查看 GitHub Releases。
MIT License
Content type
Image
Digest
sha256:bdd7380f5…
Size
104.2 MB
Last updated
12 days ago
docker pull minzgo/music-scraper