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:
