飞牛部署音乐源：TuneScout 一键部署 + 下载刮削整理 + 歌单同步

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

项目特点

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

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

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

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

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

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

创建目录和空文件

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

/vol1/1000/Dockers/TuneScout/

├── config/ # 配置持久化目录

├── library_cache.db # 数据库持久化文件（先建一个空文件）

├── download/ # 临时下载目录（中转）

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-stoppeded

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

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

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

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

使用方法

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

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

2️⃣ 系统设置

基本配置

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

下载原设置

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

AI模型

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

计划任务

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

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

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

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

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

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

5️⃣ 歌单与榜单同步

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

6️⃣整理库

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

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

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

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

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

常见问题

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

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

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

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

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

总结

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

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～