小z博客

Songloft是一款面向个人用户的自托管音乐服务器，类似于群晖的Audio Station，直接对标Navidrome，非常适合NAS用户部署。Songloft其独特之处在于：官方提供了全平台客户端和MIoT插件，因此可以支持通过小爱音箱来播放音乐。

Songloft特点

• 本地音乐管理：扫描目录，自动提取 MP3/FLAC/WAV/APE/OGG/M4A 等格式的封面与元数据
• JS 插件体系：基于 QuickJS 沙箱，支持权限模型、健康检查、热更新，可扩展音源、元数据、设备控制
• 跨平台客户端：Flutter 实现，支持 Android、iOS、macOS、Windows、Linux、Web
• Web 界面：内置完整前端，开箱即用
• JWT 认证：双 Token（Access + Refresh），支持多设备管理
• 网络歌曲与电台：支持添加用户合法持有的网络音频 URL 及电台
• 歌单转本地：将合法持有的网络 URL 离线保存到本地，按歌单分目录、可读文件名命名，转换后回写元数据/封面/歌词
• 完整 REST API：内置 Swagger 文档，便于集成与二次开发
• 轻量高效：Go 编写，内存占用低

Docker Compose部署Songloft

新建compose.yaml文件，内容如下：

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

其中：

• /path/to/music：为您本地音乐存放目录
• /path/to/data：Songloft数据持久存储目录
• ADMIN_USERNAME：为用管理员户名
• ADMIN_PASSWORD：为管理员密码

输入docker compose up -d启动服务，然后访问：http://IP:58091进行登录。

快速上手

扫描入库

首次使用，我们需要先在【设置 - 音乐库管理】，扫描本地歌曲并导入系统，如下图所示。

调用小爱音箱播放

Songloft官方提供了一个【MIoT 智能音箱投放插件】，通过安装这个插件后可调用内网的小爱音箱直接播放Songloft服务端的音乐。

插件下载地址：https://songloft.hanxi.cc/issues/4.html

然后在设置里面安装并启用插件。

继续在Songloft首页，找到插件按钮进入插件设置页面 - 设备管理，使用米家APP扫码登录完成授权。

继续勾选内网可用的小爱音箱。

在【插件设置 - 服务器设置】，填写http://IP:58091保存，不然会出现歌单为空，无法选择的情况。

最后就可以成功的调用小爱音箱播放Songloft服务端的音乐啦。

使用客户端

官方还贴心的提供了配套的Windows、Linux、macOS、Android、iOS客户端，大家可根据自己的平台下载：https://songloft.hanxi.cc/issues/8.html

结语

Songloft 是一款轻量强大的自托管音乐服务器，Docker 部署简单，资源占用低。它不仅能像群晖 Audio Station 一样管理本地音乐，更通过 MIoT 插件让小爱音箱直接播放，同时提供全平台客户端。无论是 NAS 用户还是智能家居爱好者，都值得一试。

• Songloft开源项目地址：https://github.com/songloft-org/songloft
• Songloft官网：https://songloft.hanxi.cc/