部署SqMusic，免费下无损,打造私人音乐库

书接上文，小伙伴么NAS里没有音乐咋个整，今天它来了！——SqMusic
项目地址

1. https://github.com/59799517/simple_sq_music_plus

复制代码

别人都有🐠，我们也要有😁-部署道理鱼音乐，开启纵享丝滑音乐体验！
https://club.ugnas.com/forum.php?mod=viewthread&tid=5111

项目特色

• 🎯 聚合多平台音源，搜歌、试听、下载
• 🎵 支持无损格式（FLAC、APE）和高码率MP3（320kbps），按需选码率
• 🏷️ 自动整理成「歌手/专辑/曲目」目录结构，写入ID3标签、封面、歌词
• 🎬 下载完直接被绿联自带的「音乐」、Emby、Jellyfin，道理鱼等识别
• 🔌 支持填入平台Cookie同步自己的会员歌单
• 📁 目录模板支持自定义，老司机还能用SpEL表达式玩花活
  

话不多说直接开始，docker-compose如下：
需要三个容器
sqmusic_main  主服务
sqmusic_web   WEB服务
mysql              数据库

部署步骤：

• 先在文件管理里建一个目录，比如/volume1/docker/sqmusic
• 打开Docker应用 → 项目→ 创建
• 项目名填 sqmusic（自己起），路径选刚才建的 sqmusic 文件夹
• Compose配置，把下面代码粘进去
  

注意：
1.映射的音乐目录改成你自己的，这个是存储下载的音乐的路径
    volumes:
      # 将宿主机的/music目录挂载到容器内的音乐目录
      - /volume1/音乐:/music
2.MySQL 5.7 启动比较慢，第一次如果报"连不上数据库"，多启动几次

1. version: '3.8'
   
2. services:
   
3.   # 主应用服务：sqmusic_main
   
4.   sqmusic_main:
   
5.     # 使用的镜像，来自阿里云仓库
   
6.     image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:v3.0.28
   
7.     container_name: sqmusic_main  # 容器名称
   
8.     environment:
   
9.       - DB_IP=mysql  # 数据库IP地址，指向mysql服务
   
10.       - DB_PORT=3306  # 数据库端口
    
11.       - DB_NAME=sqmusicv3  # 数据库名称
    
12.       - DB_USERNAME=root  # 数据库用户名
    
13.       - DB_PASSWORD=sqmusicv3password  # 数据库密码
    
14.     volumes:
    
15.       # 将宿主机的/music目录挂载到容器内的音乐目录
    
16.       - /volume1/音乐:/music
    
17.     depends_on:
    
18.       # 确保mysql服务在启动此容器之前已准备好并处于健康状态
    
19.       mysql:
    
20.         condition: service_healthy
    
21.     networks:
    
22.       - sq-app-network  # 使用指定的网络
    
23.     expose:
    
24.       - "8099"  # 仅暴露端口8099给其它容器，不映射到宿主机
    
25.     restart: always  # 容器崩溃后自动重启
    
26.   # Web前端服务：sqmusic_web
    
27.   sqmusic_web:
    
28.     # 使用的镜像，来自阿里云仓库
    
29.     image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:v3.0.15
    
30.     container_name: sqmusic_web  # 容器名称
    
31.     ports:
    
32.       # 将容器的80端口映射到宿主机的8096端口
    
33.       - "8096:80"
    
34.     networks:
    
35.       - sq-app-network  # 使用指定的网络
    
36.     depends_on:
    
37.       # 确保sqmusic_main服务在启动此容器之前已启动
    
38.       - sqmusic_main
    
39.     restart: always  # 容器崩溃后自动重启
    
40.   # 数据库服务：mysql
    
41.   mysql:
    
42.     # 使用的MySQL镜像版本5.7
    
43.     image: docker.1ms.run/mysql:5.7
    
44.     container_name: sqmusic_mysql  # 容器名称
    
45.     environment:
    
46.       # 设置数据库的root密码
    
47.       MYSQL_ROOT_PASSWORD: sqmusicv3password
    
48.       # 设置数据库名称
    
49.       MYSQL_DATABASE: sqmusicv3
    
50.     volumes:
    
51.       # 将宿主机的/mysql_data目录挂载到容器内的/var/lib/mysql目录，存储数据库数据
    
52.       - ./mysql_data:/var/lib/mysql
    
53.       # 可以取消下面注释来使用Docker卷来持久化数据
    
54.       # - sqmusic-db:/var/lib/mysql
    
55.     networks:
    
56.       - sq-app-network  # 使用指定的网络
    
57.     healthcheck:
    
58.       # 检查MySQL服务是否健康，尝试ping数据库
    
59.       test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
    
60.       interval: 10s  # 每10秒检查一次
    
61.       timeout: 5s  # 每次检查最多等5秒
    
62.       retries: 5  # 重试5次
    
63.     restart: always  # 容器崩溃后自动重启
    
64. # 网络配置
    
65. networks:
    
66.   sq-app-network:
    
67.     driver: bridge  # 使用bridge驱动，适合容器之间的通信

复制代码

部署完成以后，浏览器访问 http://NAS_IP:8096

• 默认账号：admin
• 默认密码：admin
• 登录后第一时间改密码！
  
  

进来以后可以选音源、搜歌、试听、选码率下载。


下载的格式是这样子的/volume1/音乐/周杰伦/叶惠美


封面、歌词、标签全部自动写入，直接就能扫到播放，不用再跑MusicTag这类刮削工具。
进阶玩法
强制只下无损
右上角「设置」里可以勾选「只下载无损格式」，从此告别320k码率的MP3。
同步自己的会员歌单
想在SqMusic里直接拉你网易云/QQ音乐/酷狗里"我喜欢"歌单？

• 用浏览器登录对应音乐平台网页版，按F12打开开发者工具
• 在Network里随便点一下，复制请求头里的 Cookie
• 回到SqMusic「设置」→ 找到对应平台，把Cookie粘进去保存
• 点「同步歌单」就能把你收藏的几百首歌全拉下来
  

Cookie默认保留7天，过期重新粘一次就行。别用主账号Cookie在陌生服务上登录，避免被风控。

自定义目录模板（高级用户）
默认目录是「歌手/专辑/歌曲」，在「设置」→「下载模板」里可以改。模板支持变量：

变量	含义
${musicName}	歌曲名
${artists}	全部歌手
${artist}	主要歌手（仅第一个）
${album}	专辑名
${albumYear}	专辑年份

比如改成 ${albumYear}/${artist}/${album}/${musicName} 就是「年份/歌手/专辑/歌曲」四级结构，方便按年代听歌。
再狠一点，项目还支持SpEL表达式（Spring表达式语言），能在模板里写 if/else/三元/方法调用——老司机自由发挥。

SqMusic，覆盖了从部署到无损下载、自动整理目录。有了sqmuisc 再结合道理鱼、箭头等音乐播放器，足以打造出自己的私有音乐库啦！

这个牛

为什么我设置完了，显示下载成功，文件夹里没有音乐文件呢

好

这个东西不会有版权方面的问题么

梦梦 发表于 2026-7-6 21:11
这个东西不会有版权方面的问题么

不知道啊😁

e2bZhK 发表于 2026-7-6 18:13
为什么我设置完了，显示下载成功，文件夹里没有音乐文件呢

你看你映射到那个文件夹了啊

显示下载成功，文件夹里没有音乐文件啊

e2bZhK 发表于 2026-7-6 18:13
为什么我设置完了，显示下载成功，文件夹里没有音乐文件呢

显示下载成功，文件夹里没有音乐文件啊，我的和你一样

为啥刮削的数据没有年份嘞，还有下载会按歌手/专辑文件夹下载、这个能调整吗