百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

simple_sq_music_plus

> 编程语言
开源

NAS音乐下载工具

771 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

NAS音乐下载工具

最新NAS坏了 等修好了再更新版本

出现问题先升级到最新版本

simple_sq_music_plus

是下载音乐工具,可以当普通的音乐下载工具使用,支持,flac,ape,mp3等格式的下载(根据码率不同), 下载的歌曲目录结构支持emby 与 subsonic(后续开放) 类的服务,下载文件支持文件标签识别,歌词下载。

javascript
\Music下载根路径
       \歌手名称
               \专辑名称
                       1- 歌曲1.flac
                       2- 歌曲2.flac

默认支持群辉等第三方音乐服务标识: emby,jellyfin识别请参考如下配置 https://support.emby.media/support/solutions/articles/44001159113-music-naming

  • 默认账号:admin
  • 默认密码:admin (登录后设置自行修改)

效果截图

接口文档:

https://59799517.github.io/simple_sq_music_plus/#/README

MCP

agsl
- 访问地址:
- http(s)://IP:端口/mcp
- 请求头:
- sqmusic=Token(设置下方的token值)

运行项目

1. docker-compose(推荐--mysql启动慢导致报错可以多运行几次)

运行docker-compose文件即可(本地编译使用docker-compose-local)

2.docker启动请参考docker-compose配置手动启动

  1. 启动mysql
dockerfile
# 拉取 MySQL 5.7 镜像
docker pull mysql:5.7

# 创建自定义网络
docker network create sq-app-network

# 运行 MySQL 容器
docker run -d \
  --name sqmusic_mysql \
  --restart=always \
  -e MYSQL_ROOT_PASSWORD=sqmusicv3password \
  -e MYSQL_DATABASE=sqmusicv3 \
  -v ./mysql_data:/var/lib/mysql \
  -p 3306:3306 \
  --network simple_sq_music_plus_sq-app-network \
  mysql:5.8
  1. 启动后端服务
dockerfile
# 拉取后端服务镜像(使用最新版本号)
docker pull registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:v3.0.8

# 运行后端容器
docker run -d \
  --name sqmusic_main \
  --restart=always \
  -e DB_IP=mysql \
  -e DB_PORT=3306 \
  -e DB_NAME=sqmusicv3 \
  -e DB_USERNAME=root \
  -e DB_PASSWORD=sqmusicv3password \
  -v ./music:/music \
  --network simple_sq_music_plus_sq-app-network \
  registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:latest
  1. 启动前段服务
dockerfile
# 拉取前端服务镜像(使用最新版本号)
docker pull registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:v3.0.5

# 运行前端容器
docker run -d \
  --name sqmusic_web \
  --restart=always \
  -p 8996:80 \
  --network simple_sq_music_plus_sq-app-network \
  registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:latest

Todo:

  1. 页面增加播放页面播放删除
  2. 支持苹果音乐(只能做到mp3 暂时不弄了 没无损无意义)
  3. 增加网易云监听歌单
  4. 增加指定格式下载
  5. 增加当前下载速度展示
  6. 增加下载暂停功能
  7. 手机模式下专辑和歌手不展示问题
  8. 增加阿里云盘同步
  9. 增加QQ音乐超限制暂停
  10. 增加咪咕音乐
  11. 增加api文档
  12. 下载失败使用其他插件进行下载
  13. 综合查询下载不根据单一插件下载查询
  14. 增加下载超时重试功能(设置增加重试间隔时间)
  15. 根据条件自定义处理下载功能(删除重试等)
  16. 增加内置网易云功能

下载模板支持(3.1.15版本后取消el表达式支持-有安全风险需要提出issues) 描述:目前支持

  1. ${musicName}---歌曲名称
  2. ${artists}---歌手名称(全部歌手)
  3. ${album}---专辑名称
  4. ${albumId}---专辑ID
  5. ${artistsId}---歌手id
  6. ${artist}------主要歌手(只有1个)
  7. ${albumTime}---------专辑时间(2020-05-21)
  8. ${albumYear}---------专辑年份(2020)
  9. ${albumMonth}---------专辑月份(05)
  10. ${albumDay}---------专辑日(21)
默认为${artists}/${album}/${musicName} - ${artists}---/歌手/专辑/歌曲名称 - 歌手名称
${album}/${musicName} - ${artists}  ------------专辑/歌曲名称 - 歌手名称```
示例:
-----------------------------
模板:${artists}/${album}/${musicName} - ${artists}
歌手目录: 周杰伦
专辑目录: 周杰伦\范特西
歌曲目录: 周杰伦\范特西\双截棍 - 周杰伦.flac
-----------------------------
模板:${album}/${musicName} - ${artists}
歌手目录: null
专辑目录: 范特西
歌曲目录: 范特西\双截棍 - 周杰伦.flac
-----------------------------
模板:/自定义文件1/${artists}/自定义文件夹2/${album}/${musicName}/自定义文件3/${musicName} - ${artists}
歌手目录: 自定义文件1\周杰伦
专辑目录: 自定义文件1\周杰伦\自定义文件夹2\范特西
歌曲目录: 自定义文件1\周杰伦\自定义文件夹2\范特西\双截棍\自定义文件3\双截棍 - 周杰伦.flac

感谢:

  1. https://github.com/MakcRe/KuGouMusicApi 酷狗API
  2. https://music.gdstudio.org 网易API下载支持

2.x迁移3.x版本

  1. 导出已经同步过的歌单、专辑、歌手信息(文件是.json)

  2. 3.0版本导入已经同步信息(时间较长耐心等待)

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Javaemby-pluginmusicmusic-downloadqunjui

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言