Songloft私有音乐服务：Docker部署与小爱音箱播放

本文由 安卿辰博客 编辑整理发布，内容来源于互联网公开资料。如需转载或引用，请注明出处。

Songloft 是一款面向个人用户的自托管音乐服务器，功能上与群晖 Audio Station 类似，并直接对标 Navidrome，特别适合 NAS 用户进行部署。其独特之处在于官方提供了全平台客户端以及 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://songloft.hanxi.cc/