Xiaomusic 是一款专为小爱音箱打造的本地音乐管理工具,核心功能是绑定小米账号后让小爱音箱直接读取 NAS 中的音乐文件,支持语音点播、随机播放、循环歌单等基础操作,适配所有能运行 Docker 的设备,无论是家用 NAS(极空间、群晖等)还是普通电脑都能部署。它的适用人群主要是有本地音乐收藏习惯、不想被音乐平台会员限制的用户,尤其是家中有小爱音箱且配备 NAS 的家庭用户,优点在于部署门槛低,无需编程基础,轻量化占用资源少,还能通过网页端可视化管理歌单和设备,操作简单易上手。
使用 Xiaomusic 时能明显感受到本地音乐调用的便捷性,比如喊一声'播放收藏的经典老歌'就能秒响应,但也有需要注意的地方:小米账号绑定后建议定期检查登录状态,避免因账号安全设置导致连接失效;NAS 中的音乐文件最好按统一格式整理,否则可能出现语音点播识别不准确的情况;另外部署时要确保存储路径设置正确,不然会出现音乐文件无法读取的问题。
不过仅在局域网内使用 Xiaomusic 会有明显的局限性,比如人在公司想给家里的老人点播戏曲,却因为不在同一网络无法操作;出门旅游时想远程调整家中小爱音箱的播放歌单也做不到;甚至家里不同楼层如果网络隔离,也会影响 Xiaomusic 的正常使用,这些都让它的使用场景被局限在'在家且连同一网络'的范围内。
而将 Xiaomusic 与 cpolar 内网穿透结合后,这些问题都能迎刃而解:无需申请公网 IP,就能让 Xiaomusic 服务暴露到外网,出差时在高铁上用手机就能远程给家里的小爱音箱点歌;cpolar 提供的固定二级子域名,不用每次重启设备都记新地址,日常使用更省心;而且穿透链路加密,不用担心小米账号或音乐文件信息泄露,同时手机、平板、电脑等多设备都能通过公网地址访问 Xiaomusic,不管是远程管理 NAS 歌单,还是给家里的小爱音箱发播放指令,都能打破局域网的限制,真正实现随时随地控制。
1. 在极空间部署 xiaomusic
1.1 SSH 远程连接到极空间
- 开启【SSH 服务】
- 使用终端(Windows PowerShell / Mac Terminal)登录:
ssh root@IP
1.2 验证 docker 是否开启
使用命令:
docker version && systemctl status docker
2. 在极空间部署 xiaomusic
使用 docker 部署的两种方式:
docker 启动命令如下:
docker run -p58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic
对应的 docker compose 配置如下:
services:






























