一、简介

用小爱音箱听本地音乐的朋友，应该对 xiaomusic 不陌生，这个项目可以让小爱音箱播放本地歌曲，还能通过语音指令切歌、播放歌单，平时听歌很方便。

不过，xiaomusic 已经宣布停止维护，原作者不再开发新功能，也不再修复 Bug，并推荐大家转向社区接力项目 Songloft。

Songloft 是一个开源音乐服务器项目，支持小爱音箱播放音乐，除了管理本地曲库，还提供 Web 播放界面、跨平台客户端和插件系统。


二、安装

Songloft 支持 Linux、Windows、macOS 等系统，也提供 Docker 镜像。如果家里有 NAS，使用 Docker 部署会比较方便。

安装步骤

第一步，选择安装方式：

• 有 NAS 或 Linux 设备，可以选择 Docker 方式部署。

• 使用 Windows 或 macOS，可以下载对应系统的程序。

• 只想在手机或电脑上播放本地音乐，也可以考虑内置服务端的 Bundle 版本。

Docker 方式示例：

# Docker 方式
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' \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  songloft/songloft:latest

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
      - PUID=1000 # 可选：设置宿主机用户 UID
      - PGID=1000 # 可选：设置宿主机用户 GID

第二步，启动服务：

根据选择的安装方式，启动程序或 Docker 容器。首次使用建议选择包含 Web 界面的完整版，启动后访问服务地址即可进入管理页面。

第三步，添加音乐：

将自己的音乐文件放进指定目录，再通过 Web 界面配置音乐目录并扫描曲库。完成后就可以开始使用了。

Songloft 提供三种版本，满足不同使用场景：

获取资料

公 Zhong 号：BugShare 发送 Songloft 获取对应平台的安装包。

三、功能

Songloft 不只是一个给小爱音箱播放音乐的工具，还提供了一套完整的个人音乐管理功能。

1. 支持小爱音箱

这是很多 xiaomusic 老用户最关心的功能。

Songloft 支持小爱音箱播放音乐，可以继续满足通过智能音箱听歌的需求，对于已经搭建好家庭音乐环境的用户来说尤其方便。

2. 管理本地音乐

Songloft 可以扫描本地音乐目录，读取歌曲信息和封面，方便整理自己的音乐库。

支持 MP3、FLAC、WAV、APE、OGG、M4A 等多种音频格式。

3. 提供 Web 界面和多平台客户端

部署完成后，可以通过浏览器访问 Web 界面，管理歌曲和歌单。

如果习惯在手机、平板或电脑上听歌，还可以使用配套的 Flutter 客户端。

注意：官方 Flutter 客户端覆盖 Android、iOS、Windows、macOS、Linux 和 Web 等平台。

4. 支持网络音频和插件扩展

除了本地音乐，Songloft 还支持添加网络音频地址和电台流，并内置 JavaScript 插件系统，可以扩展音源、元数据和设备控制等功能。

对于喜欢折腾的用户来说，也有更多扩展空间。

5. 免费开源

Songloft 是免费开源项目，没有会员、付费功能和广告。

注意：涉及网络音源、歌曲下载和转存时，仍然要注意版权问题，建议只管理和使用自己有权使用的音乐。

四、最后

xiaomusic 停止维护，对一直使用它的小爱用户来说，确实有些可惜。

好在社区已经有了 Songloft 这个接力项目，而且官方明确表示支持小爱音箱。对于想继续使用小爱音箱播放本地音乐的朋友来说，可以考虑试试。