当前位置：

社区首页

电脑数码

存储设备

网络存储

文章详情

告别音乐会员！Docker部Songloft，搭建属于自己的NAS私人音乐库

哈喽！各位值友们，你们好呀，我是爱玩nas的米菠萝

在去年，我写过一篇关于群晖部署xiaomusic的文章,实现了用小爱音箱播放nas里面的音乐，还能依托yt-dlp进行网络搜索下载播放歌曲，实现几乎和原生一样的播放效果，详情戳：

在今年五月，突然收到作者不再维护的消息，其实在这之前，我的语音搜索功能就已经无法使用了

得知作者又开发了一个新的nas音乐托管平台，并通过插件的形式实现了和xiaomusic几乎一样的语音控制播放体验，还有一些新的功能。那么欢迎来到Songloft部署教程

准备工作

你需要一台nas/服务器（能运行docker就行），一台电脑，songloft镜像（离线安装使用），插件包

开始安装

首先

打开你的nas上的docker或者container manager

有几种常见的安装方式

1.使用docker compose

services: songloft: image: songloft/songloft:latest container_name: songloft restart: always ports: - "58091:58091" volumes: - /path/to/music:/app/music - /path/to/data:/app/data environment: - ADMIN_USERNAME=admin - ADMIN_PASSWORD=your_strong_password - LISTEN_PORT=58091

把上方的代码插入就行了，这两个文件路径要改成你自己的

这个对网路环境还是有一定要求的，多试几次应该就可以了

2.使用ssh拉取

打开你的nas上的ssh功能

用你熟悉的连接软件拉取

# 🌟 完整版（推荐，包含 Web 前端，:latest 即完整版） docker pull songloft/songloft:latest # 运行容器 docker run -d --name songloft -p 58091:58091 -v /path/to/music:/app/music -v /path/to/data:/app/data -e ADMIN_USERNAME=admin -e ADMIN_PASSWORD='your_strong_password' songloft/songloft:latest

等待拉取完成以后

在映像页面找到songloft

按照向导进行配置即可

注意：在存储空间要映射两个地址，一个music是你保存音乐文件的地方，一个data保存docker数据。

3.离线安装

如果你的网络环境实在是不友好，那么你可以采用docker离线安装的方式（我就是这么装的），首先在github上找到songloft这个项目

找到这个1.4kstars的项目

往下翻，在readme里作者提供了打包好的docker镜像文件，下载下来

然后打开nas里的docker套件在映像页面选择导入

把下载好的文件导入nas

然后选择启动，填写好必填的信息参考上文拉取以后的操作

在配置完成以后，点击启动，在浏览器里输入Nas的ip+端口号（默认是58091）

恭喜你，打开了新世界的大门

开始使用

不出意外，你打开以后应该是这个页面，用户名和密码默认应该都是admin

登录以后你便进入了音乐播放界面

这时网页版的音乐库其实就已经可以使用了。这时有值友估计就要问了，米菠萝米菠萝，我想要像原来的xiaomusic一样用小爱音箱来播放可以吗？当然

安装插件

在songloft里要实现小米音箱语音控制播放只需要一个插件就行

打开设置-扩展选项卡，找到这个扩展安装就行，如果找不到，或者GitHub上不去我们可以使用离线安装的方式进行

回到GitHub songloftorg页面

进入这个插件界面

找到右边的releases

下载最上面的zip，等待下载完成以后回到songloft选择上传插件

把这个zip包上传完就行了，然后点击启用这个插件

配置插件

这是你便能在首页里找到智能音箱这个插件了

这时由于你还没有配置好这个插件你是无法使用小爱来播放的。别急，现在songloft的连接体验已经比之前的xiaomusic好了不止一个数量级了，点击左上角的设置进入配置界面

服务器地址你就填你的nas地址就行了，然后在添加账号这一栏里用你的米家app扫码登陆就行了

这时你便可以勾选上你想使用的音响进行播放了

语音搜索下载

这时又有值友要问了，米菠萝米菠萝，我也想要让小爱播放一些我音乐库里没有的音乐，该怎么办呢？这很简单，答案是插件！

忘记说了其实songloft有一个官方的插件市场指路：https://songloft-store.lllh.de/#/

你可以在这里便捷地下载到所有你需要的扩展，出了上文的智能音箱，还有马上要用到的yt-dlp下载，这里还有许许多多丰富好用的插件值得探索。

在右下角点击下载，和刚才一样导入下载好的zip文件进入扩展页面，然后打开这个yt-dlp，找到设置，点进去安装服务

然后再国内，如果你没有魔法网络环境那么你需要把下载平台改成b站

最好上传一下cookies不然容易下载失败

这是再回到智能音箱插件

启用外部搜索并且把搜索源改成yt-dlp就行了

ps:和作者交流过后得知，当前yt-dlp不是很稳定作者也建议把喜欢的歌下载以后再听

好的，现在你已经完成了songloft的下载与配配置，赶紧去试试吧

总结

Songloft的出现，不仅是停更xiaomusic的完美平替，更是NAS影音本地化与智能家居联动的优质升级方案。在如今流媒体平台版权受限、会员溢价、曲库删减、播放规则受限的大环境下，这套自建音乐托管体系，让我们彻底告别商业平台的束缚。依托NAS本地存储承载专属音乐库，搭配灵活的插件生态，我们既守住了无损音乐的音质与收藏自由，又通过小爱音箱语音联动，让本地影音资源真正融入智能家居日常场景。不同于封闭的商用影音服务，Songloft依托开源社区持续迭代，兼具轻量化、高适配、可拓展的优势，三种部署方案兼容不同网络与设备条件，新手易上手，老手可深度定制。它所带来的不止是听歌、搜歌的便捷功能，更是一种自主可控的数字生活方式，让普通NAS设备化身私人智能音乐中枢，实现影音资源私有化、播放体验智能化，为家庭本地影音生态搭建提供了极简且高效的最优解。在此特别感谢本项目开发者涵曦大佬的开源深耕与无私分享，正是开发者的持续迭代优化、打磨适配NAS场景的功能，才让我们得以用上稳定、好用的新一代本地音乐托管方案，完美解决旧项目停更的痛点。

感谢这款工具的作者大佬涵曦，欢迎去他的GitHub 主页点点 Star，支持开源作者持续创作：【hanxi (涵曦) · GitHub】https://github.com/hanxi