飞牛音乐要来了，很多人第一反应是：播放器有了，那音乐源怎么办？ 本地音乐库最怕的不是“没地方听”，而是——没有稳定的获取途径、下载一堆文件不齐全、封面歌词全靠手工、目录乱成一锅粥、歌单同步更是折腾到头皮发麻。所以今天给大家安利一个我觉得非常“省心”的项目：TuneScout。

项目特点

  • 多源音乐下载：支持网易云、QQ、酷我、B 站、YouTube 等，多品质一键获取；支持歌名/歌手/链接精准解析

  • 智能元数据刮削：自动补全封面、歌词、歌手、专辑等信息；多源聚合匹配；可批量修复本地音乐标签

  • 自动化库整理：自动整理为「歌手 / 专辑 / 歌曲」结构；智能处理合集与合唱；自动清理空目录

  • 歌单与榜单同步：一键订阅网易云/QQ 歌单与排行榜；本地自动补全缺失歌曲；生成 m3u8 播放列表，完美适配 Navidrome；支持定时更新

  • 高效任务管理：多任务并发、实时进度、详细日志；内置 Cron 定时任务，支持时区

  • 安全与部署：Web 登录认证；Docker/Compose 一键部署，公网使用更放心

创建目录和空文件

在飞牛 NAS 上创建以下结构（宿主机路径）：

/vol1/1000/Dockers/TuneScout/
├── config/                 # 配置持久化目录
├── library_cache.db        # 数据库持久化文件（先建一个空文件）
├── download/               # 临时下载目录（中转）
0-DbRk

Docker 部署 TuneScout-v2

docker-compose.yaml

services:
  tunescout:
    image: yuwancumian2009/tunescout-v2:latest
    container_name: tunescout
    environment:
      - TZ=Asia/Shanghai
      - WEB_USERNAME=admin  # Web界面登录用户名 (可选, 默认 admin)
      - WEB_PASSWORD=admin1234  # Web界面登录密码 (设置后自动开启认证)
      - PUID=1000
      - PGID=1001
    volumes:
      - ./config:/app/config
      - ./library_cache.db:/app/library_cache.db
      - /vol1/1000/音乐:/music
      - ./download:/download
      - /vol1/1000/音乐/playlists:/playlists
      # 可选：如需要自动重启 Navidrome（高级用法）再打开
      # - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - "8503:8503"
    restart: unless-stopped

  • /vol1/1000/音乐/playlists ：navidrome 相应挂载目录

1. 在飞牛主页面找到 Docker，然后点 Compose -> 新增项目

0-DhoL

2. 填好项目名称，选择路径，然后把 docker-compose.yml 里的内容复制到来源框里

0-gFyF

3. 到 Docker 管理页面，在 容器 菜单里就能看到它的运行状态

0-rVnw

使用方法

1️⃣ 浏览器访问：http://你的NASIP:8503

首次会弹出登录框，输入你在 Compose 里设置的账号密码即可进入。

0-JqDk
0-xAdB

2️⃣ 系统设置

基本配置

设置 VIP 账号的 cookie，才能拉取到 VIP 歌曲，包括音频质量的选择。

0-QXsA
下载原设置

TuneScout 将按照列表顺序依次尝试下载。如果当前源找不到歌曲或时长不符（< 60s 或 > 7min），会自动尝试下一个源。可以自行调整下载源顺序。

0-levF
AI模型

AI模型可以对少见稀缺的歌曲进行智能判断进行整理归类。支持 Gemini、OpenAI、Deepseek 等。

0-Tcug
计划任务

前面下载保存的榜单，可以定时自动同步最新榜单进行下载和整理，并且自动刮削。

0-qcnX

3️⃣ 搜索下载（支持 Bilibili & YouTube）

这部分更像“解析 + 下载”：你可以直接在 TuneScout 内搜索关键词，找到对应视频/资源，点击下载加入队列。

0-AOXg

⚠️ YouTube 通常需要网络环境支持：可在系统设置里配置相关选项。

4️⃣ 直链解析下载（同样支持 Bilibili & YouTube）

输入视频链接 → 解析 → 下载。 它和“搜索下载”本质一致，只是入口不同。

0-nmnp

5️⃣ 歌单与榜单同步

通过关键词搜索歌单 → 订阅/同步，点击 “立即执行一次同步” → 自动加入下载任务； 也可以使用官方预设榜单：勾选后点击 全部更新。

0-rCvN
0-lKCY

6️⃣整理库

下载完的歌曲可以一键整理归档：按「歌手 / 专辑 / 歌曲」结构整理，自动处理合集/合唱，清理空目录。

0-CLPb

7️⃣ 歌曲管理（批量刮削修复信息）

这里适合做“补全强迫症”的最后一公里：可以按条件筛选（缺封面/缺歌词/缺艺人等）执行刮削，一次性补齐。

0-aNpn

8️⃣ 任务管理（所有下载/同步进度都在这）

点过的下载、同步、刮削、整理任务，都会在这里显示：实时进度 + 详细日志，出了问题也好排查。

0-JAWN

常见问题

  1. 没提前创建 library_cache.db → 容器启动后数据库无法持久化；README 明确提示需要持久化挂载并提前创建同名空文件。

  2. 权限不足导致下载/整理失败 → 使用 PUID/PGID 让容器以正确用户写入挂载目录。

  3. 定时任务不执行/时间不对 → 优先检查 TZ；更新记录也提到修复定时器与时区相关问题。

  4. 歌单生成了 Navidrome 看不到 → 把宿主机 playlists 挂到 Navidrome 容器的 /music/Playlists。

  5. 公网暴露不安全 → 设置 WEB_PASSWORD 启用 Basic Auth 登录保护。

总结

TuneScout 的爽点在于：它不是“单一下载器”，而是把 音乐源、下载、整理、刮削、歌单同步、定时任务 全都做成一个闭环——真正做到“开箱即用、越用越省心”。