搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

2026-04-05 08:48:17 6点赞 66收藏 6评论

哈喽小伙伴们好,我是Stark-C~

前些天给大家分享的一款NAS上的音乐下载工具『TuneScout』的时候,很多小伙伴找到我问能不能下载无损音乐。

我这边看了下,下载到本地的基本都是mp3。不过我试听了下,mp3的码率还是很高的,如果不是专业器材,一般的手机听歌其实和无损几乎同听不出什么区别。

不过既然大家有“无损”的这个需求,我最近正好也遇到了一个同样是NAS音乐的下载工具『SqMusic』,它不仅支持的音乐资源很强大,而且还支持大家所需要的无损音乐下载,这里就来给大家分享一下吧!

关于SqMusic

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺SqMusic的全名更准确地说是“ simple_sq_music_plus”,是一款开源、可自建、面向 NAS 用户的“高质量音乐下载 + 本地音乐库构建”工具,支持多平台音源、无损格式、歌词/封面嵌入,并能自动生成 Emby/Jellyfin 友好的目录结构。

项目Github地址:https://github.com/59799517/simple_sq_music_plus

项目特征亮点:

  • 从主流音乐平台抓取音源(支持多码率、无损格式)

  • 自动整理成本地音乐库(歌手/专辑/曲目结构)

  • 自动写入 ID3 标签、封面、歌词

  • 与 Emby / Jellyfin 等媒体服务器无缝适配

SqMusic部署

PS:现在极空间的 Docker 已经支持相对路径,所以以后我们在部署 Docker 项目的时候,只需要新建一个文件夹,把 compose 文件放进去,然后 volumes 里的路径映射目录就可以自动生成,再也不需要去写那些又长又难记的绝对路径,之前吐槽极空间的路径映射不友好现在终于可以歇歇了~

不过我个人还是建议大家在没有特殊需求的情况下,继续沿用之前的“绝对路径”部署方式,明确指定到具体的数据目录。这样不仅能避免因为移动 compose 文件导致相对路径错乱的问题,也能在后期做迁移、备份、排查故障时更直观、更可控,长期运行的稳定性也会更高。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺为了让新手小白对极空间的相对路径有个基本的了解,此次部署我们就使用相对路径的部署方式。部署之前我们只需要在Docker目录里创建一个“SqMusic”的总文件夹就可以了。(事实上“SqMusic”文件夹你可以在极空间内部任意目录中创建)

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺然后点击极空间NAS的“Docker”应用,点击【Compose】 > 【新增项目】。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺在“创建项目”页面自定义项目名称,“存储位置”需要手动选择我们前面新建的SqMusi文件夹,然后勾选下方的“所有合规文件夹添加最大读写权限”,最后输入以下 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: - ./music:/music depends_on: mysql: condition: service_healthy networks: - sq-app-network expose: - "8099" restart: always ​ sqmusic_web: image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:latest container_name: sqmusic_web ports: - "8096:80" # 项目Web页面打开端口,冒号前面请勿本地冲突 networks: - sq-app-network depends_on: - sqmusic_main restart: always ​ mysql: image: mysql:5.7 container_name: sqmusic_mysql environment: MYSQL_ROOT_PASSWORD: sqmusicv3password MYSQL_DATABASE: sqmusicv3 volumes: - ./mysql_data:/var/lib/mysql ports: - "3306:3306" 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 ​

以上代码需要修改的地方就项目Web页面打开端口那里,其它的直接保持默认即可。镜像的拉取需要自行解决网络问题,粘贴到自己的NAS这边之前建议使用AI工具优化一下,以防止格式问题造成的部署失败。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺部署成功后会显示有三个容器,看到都显示正常,就说明可以使用了。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺这个时候我们回到新建的SqMusic文件夹中,可以看到里面有三个文件:

  • docker-compose.yml文件:这个就是我们部署时候的配置信息;

  • mysql_data:数据库持久化目录,选择相对路径时自动创建的;

  • music:音乐下载目录,选择相对路径时自动创建的

也就是说,只要我们不使用绝对路径,volumes 中的相对路径就会以 docker-compose.yml 所在目录为基准进行解析;compose 放在哪里,数据目录就会生成在哪里。如果该目录不存在,Docker 会自动在宿主机(NAS)上创建对应的文件夹,而这就是相对路径的优势之一。

SqMusic体验

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺项目的打开方式没什么特别,依然是浏览器状态栏输入【IP:端口号】,或者通过"sqmusic-web"容器的远程访问直接打开。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺首次登录需要输入账号和密码。默认的账号和密码均为:admin。进去之后可以在设置选项中自行更改。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺一般来说进来之后没什么特殊需求就能直接使用了,前面可以相应的调整音源,后面直接搜索自己想要的歌曲,或者喜欢的明星就可以了。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺搜索出来的资源展示的信息还是很丰富的,包括歌手,专辑,时长,还可以直接在线播放。下载的话直接选择对应的码率就可以了,无损不用说,直接选择flac格式,它就能自动下载。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺可以在下载选项里面查看歌曲的下载情况。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺下载成功的歌曲可以直接在NAS中我们设置的音乐目录中查看(本教程的音乐目录为“music”),它下载的音乐是为我们整理好的,包括完整的专辑封面。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺甚至还有单曲封面以及歌词文件。这所有的信息都可以被极空间的“极音乐”直接识别的。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺另外我们还可以通过右上角的“设置”按钮来达到自己更个性化的需求,比如说只下载无损格式的音乐。

搭建高质量私有音乐库,极空间部署NAS音乐下载工具『SqMusic』

🔺或者说你是某平台的音乐会员,我们也可以通过插件,将获取到的音乐会员平台的cookie填入进来,然后还可以直接同步平台的歌单。

最后

因为项目的特殊性,更具体的操作这里不便展示。但是我相信只要你在NAS上搭建成功,绝大多数小伙伴基本上一看就懂,有兴趣的可以试试!

目前极空间的各大NAS产品优惠继续,同时极空间部分产品还可享受白条3期或6期免息政策,180天内出现质量问题只换不修,2年官方质保。喜欢的小伙伴不要犹豫赶快入手吧,早买早享受~

好了,以上就是今天给大家分享的内容,我是爱分享的Stark-C,如果今天的内容对你有帮助请记得收藏,顺便点点关注,咱们下期再见!谢谢大家~

展开 收起
6评论

  • 精彩
  • 最新
  • 感觉还是复杂了些,我是手机上下载了再传到nas

    校验提示文案

    提交
    docker可以说是nas最基本的玩法了 [观察]

    校验提示文案

    提交
    基础不应该是备份和访问么

    校验提示文案

    提交
    收起所有回复
  • 直接用极音乐更好

    校验提示文案

    提交
  • 突然 有一天开始下走都没有速度了,是咋回事?

    校验提示文案

    提交
  • 以下是被折叠的评论 查看
已折叠部分评论
展开
收起
提示信息

取消
确认
评论举报

相关文章推荐

更多精彩文章
更多精彩文章
最新文章 热门文章
66
扫一下,分享更方便,购买更轻松