音乐刮捎神器 MusicScraper

在音乐被资本裹挟的今天，即便想简简单单的听一首歌，也要在各大平台各种缴费，对于这种对底层百姓的压榨行为，13亿中国人可以忍，我忍不了。为了更高效管理Nas音乐库、补全歌曲元信息（封面、歌词、专辑信息等），今天给大家推荐一款开源的音乐刮削神器 ——MusicScraper，它基于 Docker 构建，跨平台易部署，能一站式解决音乐库的元数据补全、批量管理等问题，堪称音乐爱好者的必备工具！同时搭配道理鱼使用，完美解决了听音乐的烦恼。

项目地址：https://github.com/SimonLYU/MusicScraper

一、MusicScraper 核心亮点

1. 全场景刮削能力，覆盖核心需求

MusicScraper 支持手动刮削、自动刮削、批量刮削三种核心模式，满足不同使用场景：

手动刮削：精准补单首 / 单专辑的元数据，自定义程度高；
自动刮削：监控音乐目录，新增歌曲自动补全信息，懒人友好；
批量刮削：一次性处理海量本地音乐库，快速规整旧收藏。

即使在试用期 / 过期后，手动刮削功能依然可用，基础需求不受限，对普通用户非常友好。

2. 离线激活机制，隐私更安全

不同于依赖云端验证的工具，MusicScraper 采用 离线激活码 机制：

激活码与设备码绑定，一码一机，避免滥用；
所有验证逻辑本地完成，无网络请求，音乐库和设备信息绝不外泄；
可生成永久激活码。

3. 跨平台部署，适配各类设备

MusicScraper 提供 amd64/arm64 双架构镜像，几乎覆盖所有常用设备：

amd64：适配 x86 架构 NAS（如绿联云）、普通 PC；
arm64：适配 ARM 架构 NAS（如群晖 DS923+）、树莓派、M1/M2 系列 Mac。

4. 数据持久化，不怕重启丢失

通过挂载数据目录，可永久保存数据库、授权信息、设备码等核心数据，重启容器 / 重装设备都不会丢失配置，省心又可靠。

二、Docker部署（其他部署方案请查看README）

创建 Compose 配置

在绿联云中创建新项目，或在群晖中创建 docker-compose.yml 文件：

yaml
services:
  music-scraper:
    image: minzgo/music-scraper:1.1.0-amd64
    container_name: music-scraper
    privileged: true  # 启用特权模式
    ports:
      - "7301:7301"
    volumes:
      - ./music:/app/music
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

访问应用

容器启动后，在浏览器访问 http://NAS_IP:端口号（如 http://192.168.1.100:7301），即可进入 MusicScraper 主界面。

三、MusicScraper 基础使用指南

1. 试用期体验

首次运行容器后，自动进入 3 天试用期，无需激活即可使用所有功能（手动 / 自动 / 批量刮削），足够体验核心能力。

2. 激活流程（试用期结束后）

步骤 1：获取设备码

打开 MusicScraper 设置页面，复制系统生成的设备码（格式如 DV3AE91EB0）。

步骤 2：联系作者

联系作者，然后打赏不同的金额可以获取永久激活码。

分享项目给Nas群或者使用Nas的朋友，也可以获取永久激活码。

步骤 3：激活应用

在设置页面输入生成的激活码（格式如 3AE9-1EB0-CB01-A565），点击 “激活” 即可，激活后会显示剩余有效期（或 “永久”）。

3. 核心功能使用

手动刮削：选中单首 / 单专辑歌曲，点击 “刮削”，自动补全封面、歌词、专辑信息等；
自动刮削：开启自动监控，新增到 /app/music 目录的歌曲会自动触发刮削；
批量刮削：选择整个音乐目录，一键批量处理所有未补全元数据的歌曲。

4. 重要注意事项

数据备份：务必保留 /app/data 目录（含设备码、授权信息），清空会生成新设备码，需重新激活；
端口冲突：部署前确认端口未被占用，自定义端口需同时修改 -p 映射和 PORT 环境变量；
架构匹配：镜像架构需与设备一致（x86 选 amd64，ARM 选 arm64），否则容器无法启动。

总结

MusicScraper 是一款兼顾易用性和功能性的音乐刮削工具，Docker 化部署让跨设备使用毫无门槛，离线激活机制保障隐私，三种刮削模式覆盖从个人轻量使用到批量管理的全场景需求。无论是整理多年的音乐收藏，还是日常维护新增歌曲，它都能大幅提升效率，强烈推荐给每一位音乐爱好者！