NAS部署Music Scraper：轻松自动获取音乐封面与歌词的终极指南

Music Scraper 是一款专为网络存储设备用户打造的轻量级音乐元数据刮削工具，它能够自动为音乐文件获取封面图像、歌词文本、艺术家详情等关键信息。该工具支持通过 Docker 容器一键快速部署，用户仅需通过网页界面即可在手机或电脑设备上便捷操作，极大简化了音乐库的管理流程。

核心功能与特性：

• 🎯 多元数据源支持：集成企鹅音乐、云村音乐、酷系音乐、苹果音乐、开放音乐库等六大主流数据源。
• 🖼️ 智能匹配算法：基于置信度评估机制，自动筛选并应用最佳匹配的元数据结果。
• 📱 移动端优化界面：采用赛博朋克美学风格的用户界面，完美适配手机与平板电脑访问。
• 🚀 便捷一键部署：提供开箱即用的 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 配置示例

通过 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 即可访问 Music Scraper 的网页管理界面。

首次访问时，需要设置一个登录密码，随后点击“开始使用”按钮进入主界面。

提示：该界面主要针对移动网页端进行了优化适配。为了在教程中更清晰地展示界面元素，以下截图均使用 PC 网页端进行演示。

进入主界面后，可以看到系统提供了手动刮削与自动刮削两种主要的元数据处理模式。

首先进入“设置”菜单，配置基础的刮削偏好选项。

提示：新用户可享受 3 天全功能免费试用期。试用期结束后，部分高级功能将受限，但核心刮削功能仍可继续使用。

点击启用“自动检测”功能模块。系统已预设了合理的默认配置，用户可根据自身需求进行自定义调整。

用户可以在此配置多个需要监测的音乐文件夹路径，并设置自动扫描的时间间隔等参数。

数据源选择页面支持勾选多个来源。通常前两个主流数据源已能覆盖绝大多数音乐，但勾选更多源可以提高匹配成功率。

重点需要关注“写入字段”配置部分。建议将所有可写入字段全部勾选，尤其是将歌词内嵌至音频文件，这样在整理音乐库时只需管理单个文件，更为便捷。

页面底部的去广告功能也建议开启。如果希望对已有元数据的文件进行重新整理，可以关闭“跳过已有信息”选项。

配置无误后，点击启用自动监测功能。

点击“开始扫描”按钮，至此自动监测功能便配置完成。

返回主页面，点击进入“自动刮削”模块进行相关设置（目前自动检测与自动刮削需要分别配置，期待后续版本能简化此流程）。

此处的设置选项与前述自动检测模块基本一致，不再赘述。

在映射的本地音乐文件夹路径中，建议先放入少量音乐文件进行测试，确认刮削效果满意后，再进行大规模批量处理。

返回网页界面，可以看到刚刚放入的音乐文件已被自动刮削完成。

点击任意文件进入详情页面，可以查看已获取的基本信息（若歌词被识别为独立的外部文件，系统可能不会在此显示检测状态）。

提示：如果自动刮削未能成功识别某文件，用户仍可手动触发刮削处理。手动模式操作直观简单。

上图展示了音乐文件在未经刮削处理前的状态（可能包含部分基础信息，但通常缺失封面图像与歌词）。

经过 Music Scraper 处理后的效果对比如上图所示，元数据的完整度与视觉体验提升显著。

使用总结与评价

以往手动为音乐库添加元数据的过程往往较为繁琐。相比之下，Music Scraper 这款工具提供了极大的便利性，用户只需完成初始配置，即可实现全自动化的后台刮削，持续运行无需干预。

• 综合推荐指数：⭐⭐⭐⭐（功能全面，自动化程度高，非常值得部署）
• 实际使用体验：⭐⭐⭐（配置过程简单明了，自动化运行省心省力）
• 部署难度评级：⭐⭐（基于 Docker 的部署方式极为简单）