用 NAS 攒歌库的应该都遇到过这两个烦:
一是下载工具下回来的歌,文件名乱七八糟,没封面没歌词,飞牛音乐里刮削半天也对不上号;二是自己收藏了几百首的"我喜欢"歌单,想整个搬回 NAS,只能一首首搜着下,下到怀疑人生。
今天介绍的 SqMusic,就是冲着这两个烦来的:搜歌下载一条龙,下完自动按"歌手/专辑/曲目"分好文件夹,ID3 标签、封面、歌词全给你写进文件里,飞牛音乐、Jellyfin、Emby 扫一下直接就能听。更狠的是,填个 Cookie 还能把你网易云、QQ 音乐、酷狗的收藏歌单整个同步回来。
老规矩说明一句:工具本身不内置音源,仅供个人学习交流使用,请支持正版。
一、飞牛部署:一段 Compose 三个容器
SqMusic 是后端 + 前端 + MySQL 数据库的三件套结构,但不用慌,一段 Compose 全搞定:
1. 文件管理里建个目录,比如
/vol1/1000/sqmusic2. Docker → Compose → 新建项目,路径选刚才的目录,粘贴下面的配置:
services:
sqmusic_main:
image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:latest
container_name: sqmusic_main
environment:
- DB_IP=mysql
- DB_PORT=3306
- DB_NAME=sqmusicv3
- DB_USERNAME=root
- DB_PASSWORD=sqmusicv3password
volumes:
- /vol1/1000/sqmusic/music:/music
depends_on:
mysql:
condition: service_healthy
expose:
- "8099"
networks:
- sq-app-network
restart: always
sqmusic_web:
image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:latest
container_name: sqmusic_web
ports:
- "8996:80"
depends_on:
- sqmusic_main
networks:
- sq-app-network
restart: always
mysql:
image: docker.1ms.run/mysql:5.7
container_name: sqmusic_mysql
environment:
MYSQL_ROOT_PASSWORD: sqmusicv3password
MYSQL_DATABASE: sqmusicv3
volumes:
- ./mysql_data:/var/lib/mysql
networks:
- sq-app-network
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
interval: 10s
timeout: 5s
retries: 5
restart: always
networks:
sq-app-network:
driver: bridge三个服务必须都在
sq-app-network里,这是最容易翻车的地方——网上流传的不少版本给sqmusic_main和sqmusic_web漏写了networks,结果后端解析不到DB_IP=mysql、启动就崩,前端登录只会一直转圈报"网络错误"。
要改的就两处:
• 音乐目录:
/vol1/1000/sqmusic/music换成你自己的音乐文件夹——建议直接指向飞牛音乐正在扫描的那个目录,下载完自动进曲库• 端口 8996:被占就换左边,右边别动
镜像走的是阿里云仓库,国内拉取不卡,不用配加速。
部署完访问 http://NAS的IP:8996,默认账号密码都是 admin——登录第一件事改密码,老规矩。
二、核心玩法
搜歌下载:
顶部搜索框直接搜歌,结果列表里每首都能试听,下载前可以选码率:FLAC 无损、320k、128k 随你挑,勾上"只下载无损"就不会误下 MP3。
下载完自动"装修"
这是它和普通下载工具拉开差距的地方:下完的歌自动建好 歌手/专辑/歌曲 目录,封面、歌手照片、歌词(lrc)、ID3 标签全部写入文件本身。我实测下载一首歌,回到文件管理看到的是整整齐齐一个专辑文件夹,直接被飞牛音乐扫出来,不用再跑 MusicTag 这类刮削工具。
歌单整体搬回家
设置里填入音乐平台的 Cookie,点"同步歌单",收藏夹几百首一次性拉回 NAS。Cookie 用浏览器 F12 从对应平台的请求头里复制,默认 7 天过期,过期重新粘一次。
⚠️ 提醒:Cookie 等于你的登录凭证,别在来路不明的服务里乱填。这类工具消费平台接口有被风控的可能,建议用小号操作。
目录模板可自定义(进阶)
设置 → 下载模板里能改目录结构,默认"歌手/专辑/歌曲",改成"年份/歌手/专辑"就能按年代整理,玩花活的还支持表达式语法,这里不展开。
FAQ
Q:和之前写的觅音、Go Music DL 什么关系?
分工不同:SqMusic 强在下载后的整理(标签封面歌词一步到位)和歌单批量搬运,日常找歌试听还是觅音顺手。下载目录可以都指向同一个音乐文件夹,互相不冲突。
Q:ARM 架构的飞牛能装吗?
可以,最近的版本已经是多架构镜像,x86 和 ARM 都能跑。
Q:搜出来搜不到某些歌?
音源接口偶尔抽风是常态,换个关键词或者过会儿再试。这类工具的本质是聚合搜索,接口稳定性谁都不敢打包票,多备一个工具总没错。
Q:公网能用吗?
能用但别裸奔——这工具没有多用户体系,暴露公网等于把下载功能敞开,配合 FN Connect 或 Tailscale 再出门。
评论区