🎵Music Scraper: NAS音乐刮削神器，发烧友快快搞起来！

宝子们！今天咱们不聊别的，就来挖个宝藏！💎 作为一个资深NAS玩家和音乐发烧友，我可太懂那种痛苦了：辛辛苦苦攒了一堆高品质音乐，结果在播放器里一看，封面是白的、歌词是空的，艺术家信息也是乱七八糟，瞬间感觉耳朵里的音符都不香了！😭 手动修改？一首歌一首歌地搞，那不得改到地老天荒啊？

别急！今天我就来给大伙儿安利一个专为咱们NAS玩家打造的音乐元数据“救星”—— Music Scraper！🚀 别看名字有点“洋气”，但它干的事儿可太接地气了，简直就是咱们NAS音乐库的“美容大师”兼“信息整理小能手”！

🏷️ Music Scraper是个啥？它能解决你的“强迫症”吗？

简单来说，Music Scraper就是一个超级轻巧的工具，专门帮你自动给音乐文件“贴标签”，比如漂亮的专辑封面、精准的歌词，还有详细的艺术家和专辑信息等等。它可不是什么复杂的软件，专为NAS优化，Docker一键就能部署，手机、电脑打开网页就能操作，简直不要太方便！

你是不是也有这些“小烦恼”？

音乐文件没有封面，播放器里一片白茫茫？☁️
歌曲信息残缺不全，想按专辑或艺术家分类都分不了？🤯
手动一首首地去网上找信息、填信息，想起来就头大？🤕

Music Scraper就是来帮你终结这些烦恼的！它能自动帮你把这些活儿都搞定，让你那堆宝贝音乐文件瞬间“颜值爆表”！

🏷️ 它的“超能力”有哪些？

别看Music Scraper小巧，它的功能可是相当强大，简直就是音乐库的“变形金刚”！

🎯 多数据源，想刮哪儿就刮哪儿！
它支持企鹅音乐、云村音乐、酷狗、酷沃、苹果音乐和开放数据库，足足6大音乐数据源！华语、欧美、日韩，通通拿下！如果首选源数据不全，它还会自动从其他源给你补齐，细节控狂喜！
🖼️ 智能匹配，不再“认错人”！
内置“火眼金睛”的置信度算法，能自动帮你选出最最准确的匹配结果，告别张冠李戴的尴尬。
📱 移动端适配，手机平板也能用！
赛博朋克风的UI设计，深色背景配霓虹色彩，炫酷又实用，在手机或平板上用着也丝滑顺畅。
🚀 一键部署，NAS小白也能轻松搞定！
Docker镜像开箱即用，简直是为NAS用户量身定制的，分分钟就能跑起来。
📦 批量处理，效率杠杠的！
支持整个文件夹自动批量刮削，就算你有成千上万首歌曲，也能解放双手，喝杯咖啡的功夫就搞定。
🎵 多格式支持，你的音乐都能刮！
MP3、FLAC、M4A、OGG、WAV、WMA，这些主流格式它都支持，再也不用担心“挑食”了。
📝 歌词获取 & 🎤 内嵌歌词，听歌跟着唱！
不仅能自动下载歌词并保存成LRC文件，还能直接把歌词写入音频文件里（比如MP3、FLAC等），这样你的播放器就能直接显示歌词啦！

🏷️ 上手部署，一键搞定！安装教程手把手！

作为NAS玩家，玩Docker是基本操作了对吧？Music Scraper的部署也是基于Docker，超简单！

方式一：Docker Hub 拉取（最最最简单的方法！）

如果你的NAS能联网访问Docker Hub，那就像“网购”一样，直接拉取就行：

# 如果你的NAS是x86架构（比如绿联云、威联通、一部分群晖），用这个：
docker pull minzgo/music-scraper:1.0.3-amd64

# 如果你的NAS是ARM架构（比如一部分群晖、树莓派），用这个：
docker pull minzgo/music-scraper:1.0.3-arm64

# 拉取完镜像，就可以运行容器啦！记得把路径换成你自己的哦！
docker run -d \
  --name music-scraper \
  -p 7301:7301 \
  -v /你的音乐目录:/app/music \  # 👈 这里换成你NAS上存音乐的路径
  -v /持久化目录:/app/data \    # 👈 这里换成你NAS上保存配置和数据的路径
  -e TZ=Asia/Shanghai \        # 👈 设置时区，中国的小伙伴用这个
  --restart unless-stopped \   # 👈 让它开机自启，永不停止！
  minzgo/music-scraper:1.0.3-amd64 # 👈 根据你的架构选择amd64或arm64

方式二：Docker 命令行（给喜欢折腾的“高级玩家”！）

如果你有SSH访问权限，或者在Linux服务器上部署，也可以先下载好镜像文件再导入：

# 1. 先导入镜像（假设你的.tar镜像文件就在当前目录）
docker load -i music-scraper-1.0.3-amd64.tar

# 2. 导入成功后，运行容器的方式和上面差不多：
docker run -d \
  --name music-scraper \
  -p 7301:7301 \
  -v /你的音乐目录:/app/music \  # 👈 再次强调，换成你的路径！
  -v /持久化目录:/app/data \    # 👈 你的持久化目录！
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  music-scraper:1.0.3-amd64 # 👈 根据你的架构选择

方式三：Docker Compose（推荐！懒人福音，配置一劳永逸！）

对于咱们NAS玩家来说，Docker Compose简直是神器！一个文件搞定所有配置，下次升级或者迁移都超级方便！

新建 docker-compose.yml 文件：
在你NAS上你喜欢放Compose文件的地方，新建一个名为 docker-compose.yml 的文件（可以用文本编辑器，比如记事本、VS Code或者NAS自带的文件管理器）。

粘贴以下内容到文件里：

services:
  music-scraper:
    image: minzgo/music-scraper:1.0.3-amd64 # 根据你的NAS架构选择amd64或arm64
    container_name: music-scraper
    restart: unless-stopped
    ports:
      - "7301:7301" # 宿主机端口:容器端口，冒号前面可以改成你喜欢的端口
    volumes:
      - /你的音乐目录:/app/music # 👈 改成你NAS上存音乐的路径
      - /持久化目录:/app/data   # 👈 改成你NAS上保存配置和数据的路径
    environment:
      - TZ=Asia/Shanghai      # 👈 设置时区，中国的小伙伴用这个
      - PORT=7301             # 容器内部的服务端口，保持默认即可
      # - MUSIC_DIR=/app/music # 如果你的音乐目录和volumes里一样，这里可以不写
      # - DATA_DIR=/app/data   # 如果你的数据目录和volumes里一样，这里可以不写
    restart: unless-stopped # 让它开机自启，永不停止！

注意啦！ 记得把 image 后面的架构 (amd64 或 arm64) 换成你NAS的实际架构！还有，volumes 下面的 /你的音乐目录 和 /持久化目录 也别忘了改成你NAS上的真实路径哦！

运行容器：
保存好 docker-compose.yml 文件后，通过SSH连接到你的NAS，cd到 docker-compose.yml 文件所在的目录，然后运行下面这句命令：
```
docker compose up -d
```
这条命令会根据你的 docker-compose.yml 文件自动拉取镜像、创建并启动容器，而且 -d 参数会让它在后台运行，不占用你的终端。

小提醒： 运行容器后，你就可以通过 http://你的NAS_IP:7301 访问Music Scraper的网页界面啦！

🏷️ 实战操作，跟我来！Music Scraper使用指南

搞定部署，接下来就是享受成果的时间了！Music Scraper的操作非常直观，就像玩游戏一样简单。

1️⃣ 浏览音乐文件
打开网页后，点首页的“浏览文件”卡片，然后就像在文件管理器里一样，导航到你的音乐文件夹。点一下音乐文件，就能看到它当前的元数据信息。
2️⃣ 手动刮削单首歌曲
在文件浏览里，选中你想“改造”的歌曲，然后点击“刮削”按钮。你可以选择数据源（华语歌曲推荐企鹅或云村），从搜索结果里挑一个最准的。接着勾选你想要写入的信息（比如封面、标题、艺术家等），最后“确认写入”就搞定啦！
3️⃣ 自动批量刮削
这是我最常用的功能！回到首页，点“自动刮削”卡片。
- 选择目录： 选好你要批量处理的音乐文件夹。
- 配置选项：
  - 数据源： 可以多选几个，它会智能互补。
  - 字段： 选好你需要的信息（封面、歌词、标题等）。
  - 最低置信度： 建议设置个70%左右，太低容易匹配错，太高又可能漏掉。
  - 跳过已有： 如果文件已经有封面或歌词了，要不要跳过？
- 一切设置妥当，点“开始刮削”，然后就可以去泡杯茶，等待它自动完成啦！☕

4️⃣ 查看刮削历史
首页的“刮削记录”卡片，可以查看你之前所有的刮削任务和结果，每首歌刮削了什么信息，清清楚楚。
5️⃣ 查看音乐库统计
想知道你的音乐库有多“完美”吗？点“音乐库概览”卡片，就能看到元数据完整度、格式分布、刮削覆盖率等统计数据，简直是强迫症的福音！

🏷️ 进阶小技巧！玩转Music Scraper的秘密武器！

Music Scraper还提供了一些小配置，让你用起来更顺手！

环境变量（Environment Variables）
部署Docker时可以设置一些环境变量来调整服务端口、音乐目录、数据存储目录和时区，比如：
- PORT=7301：服务端口
- MUSIC_DIR=/app/music：音乐文件目录
- DATA_DIR=/app/data：数据存储目录
- TZ=Asia/Shanghai：时区设置
封面尺寸设置
在“设置”页面，你可以选择下载封面的分辨率大小，从300px到1000px都有，中等尺寸（500px）通常是推荐的，兼顾显示效果和文件大小。
支持的音频格式
Music Scraper支持几乎所有常见的音频格式，而且大部分都支持元数据和封面内嵌，连歌词都能塞进去！WAV格式的元数据支持有限，封面也无法嵌入，如果对它有要求，建议转成其他格式哦。
🌐 数据源说明
- 企鹅音乐： 华语歌曲首选，封面高清。
- 云村音乐： 华语歌曲备选，歌词资源也不错。
- 酷狗音乐： 歌词资源特别丰富。
- 酷沃音乐： 曲库也挺全，可以作为备用。
- 苹果音乐： 欧美日韩歌曲覆盖好。
- 开放数据库： 数据更规范，适合专业玩家。
  💡 小建议： 多勾选几个数据源，Music Scraper会自动帮你选出置信度最高的，并从其他源补齐缺失信息，简直是懒人福音！

🏷️ Q&A时间到！常见问题，一网打尽！

Q: 刮削后封面没有显示？
A: 检查一下你的播放器支不支持嵌入式封面，或者尝试刷新一下播放器的媒体库。有些老播放器可能需要重启才能识别新封面哦。
Q: 为什么有些歌曲匹配不到？
A: 可能原因：
1. 文件名不规范，建议改成“艺术家 - 歌曲名”这种格式。
2. 歌曲太冷门了，数据源里可能没有收录。
3. 尝试换其他数据源试试，或者手动搜索一下。
Q: 刮削速度有点慢？
A: 为了避免被音乐数据源“反扒”，Music Scraper会自动限速。如果你批量处理大量文件，请耐心等待，慢工出细活嘛！
Q: 如何备份刮削数据？
A: 只需要备份你挂载的 /app/data 目录（或者你实际设置的持久化目录），所有的刮削记录和设置就都在里面了。
Q: 支持哪些NAS设备？
A: 只要你的NAS支持Docker，基本上都能用！比如绿联云（x86）、群晖、威联通、华硕等等，都完全OK！