minzgo/music-scraper Docker 镜像 - 轩辕镜像
minzgo/music-scraper专为 NAS 用户打造的音乐元数据刮削工具
3 收藏0 次下载activeminzgo镜像
🎵 Music Scraper
专为 NAS 用户打造的音乐元数据刮削工具
自动获取音乐文件的封面、歌词、艺术家等信息，支持 6 大音乐数据源，智能匹配最佳结果。
✨ 功能特性
- 🎯 多数据源：企鹅、云村、酷系、苹果、开放库等 6 大音乐数据源
- 🖼️ 智能匹配：基于置信度算法自动选择最佳匹配结果
- 📱 移动端适配：赛博朋克风格 UI，支持手机/平板访问
- 📦 批量处理：支持整个文件夹自动批量刮削
- 🎵 多格式支持：MP3、FLAC、M4A、OGG、WAV、WMA 等
- 📝 歌词获取：自动下载歌词并保存为 LRC 文件
- 🎤 内嵌歌词：支持将歌词直接写入音频文件元数据（MP3/FLAC/M4A/OGG/WMA/WAV/AIFF/APE/WavPack 等）（v1.0.3 新增，v1.0.5 扩展格式）
- 🔄 多源互补：首选源缺少数据时，自动从其他源补充
- 🔍 自动监测：定时扫描目录，自动检测新增文件并刮削，智能扫描策略（v1.0.2 新增）
- 📀 本地资源优先：自动读取目录下的 CUE 文件和封面图片（v1.0.2 新增）
- ⚡ 性能优化：动态线程池、并行 I/O、批量数据库操作，索引速度提升 2-4 倍（v1.0.3 新增）
- 📡 实时状态推送：Overview 扫描状态实时推送，前端 UI 响应更快（v1.0.3 新增）
- 🛡️ 广告过滤：自动识别并清理音乐标签中的广告内容，保持元数据干净整洁（v1.0.5 新增）
- ⚡ 熔断保护：数据源连续失败后自动熔断，避免无效请求，提升稳定性（v1.0.8 新增）
- 🔐 登录认证：密码保护 + 两步验证（2FA），保护您的音乐库安全（v1.1.0 新增）
🚀 快速开始
拉取镜像
bash# x86 架构（绿联云、威联通、部分群晖） docker pull minzgo/music-scraper:1.1.0-amd64 # ARM 架构（部分群晖、树莓派） docker pull minzgo/music-scraper:1.1.0-arm64
运行容器
基础部署（推荐挂载数据目录）：
bashdocker run -d \ --name music-scraper \ -p 7301:7301 \ -v /你的音乐目录:/app/music \ -v /数据目录:/app/data \ -e TZ=Asia/Shanghai \ --restart unless-stopped \ minzgo/music-scraper:1.1.0-amd64
特权模式部署（设备码基于硬件信息，更稳定）：
bashdocker run -d \ --name music-scraper \ --privileged \ -p 7301:7301 \ -v /你的音乐目录:/app/music \ -v /数据目录:/app/data \ -e TZ=Asia/Shanghai \ --restart unless-stopped \ minzgo/music-scraper:1.1.0-amd64
💡 特权模式优势：使用
--privileged模式部署时，设备码会基于硬件信息（系统UUID、MAC地址、磁盘序列号等）生成，即使不挂载/app/data目录，设备码也能保持稳定不变。这对于需要稳定设备码的场景（如激活码绑定）非常有用。
Docker Compose
基础配置：
yamlversion: '3' services: music-scraper: image: minzgo/music-scraper:1.1.0-amd64 container_name: music-scraper ports: - "7301:7301" volumes: - /你的音乐目录:/app/music - ./data:/app/data environment: - TZ=Asia/Shanghai restart: unless-stopped
特权模式配置（推荐，设备码更稳定）：
yamlversion: '3' services: music-scraper: image: minzgo/music-scraper:1.1.0-amd64 container_name: music-scraper privileged: true # 启用特权模式 ports: - "7301:7301" volumes: - /你的音乐目录:/app/music - ./data:/app/data environment: - TZ=Asia/Shanghai restart: unless-stopped
访问使用
浏览器打开 [***] 即可使用！
⚙️ 配置说明
端口
| 端口 | 说明 |
|---|---|
7301 | Web 服务端口 |
数据卷
| 路径 | 说明 |
|---|---|
/app/music | 音乐文件目录（必需） |
/app/data | 数据存储目录（配置、数据库、缓存） |
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
PORT | 7301 | 服务端口 |
TZ | UTC | 时区设置 |
🏷️ 标签说明
| 标签 | 架构 | 适用设备 |
|---|---|---|
1.1.0-amd64 / 1.1-amd64 | x86_64 | 绿联云、威联通、群晖(Intel)、PC/服务器 |
1.1.0-arm64 / 1.1-arm64 | ARM64 | 群晖(ARM)、树莓派 4、Apple Silicon |
💡 推荐使用：
1.1.0-amd64或1.1.0-arm64（最新版本），1.1-amd64和1.1-arm64为兼容标签
🔧 支持的音频格式
- ✅ MP3 (ID3v2) - 支持元数据、封面、歌词
- ✅ FLAC (Vorbis) - 支持元数据、封面、歌词
- ✅ M4A/AAC (MP4) - 支持元数据、封面、歌词
- ✅ OGG (Vorbis) - 支持元数据、封面、歌词
- ✅ WMA (ASF) - 支持元数据、封面、歌词
- ⚠️ WAV - 有限元数据支持，支持歌词（v1.0.5 新增）
- ✅ AIFF - 支持元数据、歌词（v1.0.5 新增）
- ✅ APE (Monkey's Audio) - 支持元数据、歌词（v1.0.5 新增）
- ✅ WavPack - 支持元数据、歌词（v1.0.5 新增）
🌐 数据源
| 数据源 | 特点 |
|---|---|
| 企鹅音乐 | 华语覆盖全，封面高清 |
| 云村音乐 | 华语覆盖好，有歌词 |
| 酷狗音乐 | 歌词资源丰富 |
| 酷沃音乐 | 曲库较全 |
| 苹果音乐 | 欧美日韩覆盖好 |
| 开放数据库 | 数据规范 |
📝 更新日志
v1.1.0 (2025-12)
🔐 新功能：登录认证系统
- 🔒 密码保护：支持设置登录密码，保护您的音乐库不被未授权访问
- 📱 两步验证（2FA）：支持 TOTP 验证器（Google Authenticator 等）
- 🔑 恢复码：生成一次性恢复码，防止丢失验证器后无法登录
- 🛡️ 暴力破解保护：连续失败后自动锁定
- 🔄 老用户升级：自动检测并提示设置密码，数据完全保留
v1.0.9 (2025-12)
✨ 新功能
- 🎨 双主题支持：新增粉色赛博朋克亮色主题「樱」，支持在设置页面切换暗夜/樱主题
- ✏️ 手动编辑元数据：支持直接编辑标题、艺术家、专辑、年份、流派，支持封面图片上传/更换
- 🎤 双语歌词合并：自动将原文歌词和翻译歌词按时间戳合并，支持网易云音乐、QQ音乐数据源
⚡ 性能优化
- 🚫 任务取消优化：改为非阻塞模式，添加「正在取消任务...」提示，更快响应取消请求
🐛 Bug 修复
- 修复第二次覆写刮削时封面丢失的问题（缓存命中后重新获取封面数据）
- 修复手动点击立即扫描触发自动刮削卡住的问题（改用标志位避免线程竞态）
v1.0.8 (2025-12)
✨ 新功能
- 🛡️ 熔断器机制：数据源连续失败后自动熔断，避免无效请求
- 连续失败 10 次后熔断 60 秒
- 新增 API：
/api/circuit-breaker/status和/api/circuit-breaker/reset
⚡ 性能优化
- 🚀 并发控制优化：降低并发数，减少数据库写锁竞争
- MAX_WORKERS: 3 → 1-2（动态计算）
- MAX_IN_FLIGHT: 30 → 6
- ⏱️ 动态超时阈值：消除"卡住任务"误判问题
- 误判次数从 762 次降至 0 次
- 💾 刮削时暂停后台任务：刮削期间跳过缓存清理、索引更新等后台任务
- 📊 进度页面优化：结果列表改为 API 分页获取，避免前端内存溢出
v1.0.5 (2025-12)
✨ 新功能
- 🛡️ 广告过滤功能：自动识别并清理音乐标签中的广告内容
- 支持清理推广信息（下载、关注、音乐平台推广等）
- 支持清理网站链接（HTTP/HTTPS、域名）
- 支持清理联系方式（QQ群、微信、微博等）
- 支持清理版权声明和特殊标记
- 用户可通过界面自定义广告关键词
- 📄 任务文件列表页面：新增任务文件详情查看功能
- 可查看每个任务处理的文件列表
- 支持按状态筛选（成功/失败/跳过）
- 支持查看文件处理详情和错误信息
- 🎨 网站图标支持：新增 favicon，提升用户体验
🎤 歌词功能增强
- 📝 扩展音频格式歌词支持：新增多种格式的内嵌歌词写入
- WAV：支持 USLT 标签歌词写入
- AIFF：支持 USLT 标签歌词写入
- APE：支持 APEv2 文本字段歌词写入
- WavPack：支持 APEv2 文本字段歌词写入
⚡ 性能优化
- 💾 数据库索引优化：新增多个关键索引，提升查询性能
- 目录快照索引：
idx_dir_snapshots_ns_path - 已知目录索引：
idx_known_dirs_path - 已知文件索引：
idx_known_files_path - API 缓存索引：
idx_search_cache_source_query、idx_detail_cache_source_id - 元数据备份索引：
idx_metadata_backups_path
- 目录快照索引：
- 🔍 任务管理优化：优化数据库查询性能和任务数据一致性
- 📊 文件浏览器优化：优化导航和搜索状态恢复机制
🔧 设备码优化
- 🔑 设备码生成逻辑优化：改进设备码生成机制
- 优化基于硬件信息的稳定设备码生成
- 改进设备码持久化存储逻辑
- 提升设备码在不同部署环境下的稳定性
🐛 Bug 修复
- 修复移动端扫描间隔输入框数字显示不完整的问题
- 修复文件浏览器导航和搜索状态恢复问题
- 修复任务管理数据一致性问题
- 优化历史记录查询性能
v1.0.3 (2025-12)
⚡ 性能优化
- 🚀 并行 I/O 优化：动态线程池大小，根据 CPU 核心数自动调整（2-6 线程）
- 📊 建立索引性能提升：批量数据库操作、消除重复遍历，索引速度提升 2-4 倍
- 🔄 统计功能优化：实时数据获取、批量写入优化，响应速度提升 50-75%
- 💾 数据库查询优化：统一 DB 查询线程池（3-4 线程），避免阻塞 gevent 事件循环
- 📈 Overview 数据获取优化：事务性获取所有数据，确保数据一致性
✨ 功能改进
- 🎤 内嵌歌词支持：支持将歌词直接写入音频文件元数据（MP3/FLAC/M4A/OGG/WMA 等），无需外部歌词文件
- 📡 Overview 实时状态推送：通过 Socket.IO 实时推送扫描状态（scanning/completed/error）
- 🎨 前端 UI 优化：加载状态实时显示、扫描进度实时更新
🐛 Bug 修复
- 修复文件浏览页面点击卡顿问题（事件委托、批量渲染优化）
- 修复返回按钮无响应问题（事件优先级调整、延迟初始化）
- 修复自动监测触发的批量刮削 Socket 推送卡顿问题（队列机制）
- 修复 Overview 数据获取显示为 0 的问题（事务性获取、回退机制）
- 修复统计页面数据刷新问题（实时更新、缓存优化）
v1.0.2 (2025-12)
- 🔥 自动监测：定时扫描目录，自动检测新增文件并刮削
- ⚡ 智能扫描：两阶段扫描策略，5-20 秒自适应间隔
- 🛡️ 还原保护：还原后的文件 48 小时内不会被自动刮削
- 🖼️ 本地资源优先：自动读取目录下的封面图片和 CUE 文件
- 📀 CUE 文件解析：支持 GBK/Big5/UTF-8 编码
- 🎨 UI 优化：忽略文件弹窗赛博朋克风格、置信度滑块渐变
- 🐛 Bug 修复：Socket.IO 重连、还原封面丢失等问题
v1.0.0 (2025-12)
- 首个公开发布版本
📖 更多信息
- GitHub: 项目主页
- 问题反馈: 请在 GitHub Issues 中提交
📄 许可证
MIT License
openstates/scrapers
by Open States
暂无描述
2500K+ pulls
上次更新：7 小时前
linuxserver/musicbrainz
by linuxserver.io
由LinuxServer.io提供的MusicBrainz容器，用于音乐元数据库服务。
7410M+ pulls
上次更新：4 年前
jlesage/musicbrainz-picard
by jlesage
MusicBrainz Picard的Docker容器，提供跨平台音乐标签工具，基于MusicBrainz数据库，支持通过现代网页浏览器访问GUI，无需客户端安装配置，方便在Docker环境中管理音乐标签信息。
110K+ pulls
上次更新：7 天前
openstates/scrapers-california
by Open States
暂无描述
10K+ pulls
上次更新：3 个月前
qmmusic/qm-music
by qmmusic
提供私人音乐服务的Docker镜像，用于搭建个人音乐服务平台。
10K+ pulls
上次更新：4 天前
xhongc/music_tag_web
by xhongc
Music Tag 音乐标签web版
731M+ pulls
上次更新：11 天前
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"