Xiaomusic 让小爱音箱解锁本地曲库，内网穿透更能远程点歌
Xiaomusic 是一款专为小爱音箱打造的本地音乐管理工具，核心功能是绑定小米账号后让小爱音箱直接读取 NAS 中的音乐文件，支持语音点播、随机播放、循环歌单等基础操作，适配所有能运行 Docker 的设备，无论是家用 NAS（极空间、群晖等）还是普通电脑都能部署。它的适用人群主要是有本地音乐收藏习惯、不想被音乐平台会员限制的用户，尤其是家中有小爱音箱且配备 NAS 的家庭用户，优点在于部署门槛低，无需编程基础，轻量化占用资源少，还能通过网页端可视化管理歌单和设备，操作简单易上手。
使用 Xiaomusic 时能明显感受到本地音乐调用的便捷性，比如喊一声 “播放收藏的经典老歌” 就能秒响应，但也有需要注意的地方：小米账号绑定后建议定期检查登录状态，避免因账号安全设置导致连接失效；NAS 中的音乐文件最好按统一格式整理，否则可能出现语音点播识别不准确的情况；另外部署时要确保存储路径设置正确，不然会出现音乐文件无法读取的问题。
不过仅在局域网内使用 Xiaomusic 会有明显的局限性，比如人在公司想给家里的老人点播戏曲，却因为不在同一网络无法操作；出门旅游时想远程调整家中小爱音箱的播放歌单也做不到；甚至家里不同楼层如果网络隔离，也会影响 Xiaomusic 的正常使用，这些都让它的使用场景被局限在 “在家且连同一网络” 的范围内。
而将 Xiaomusic 与 cpolar 内网穿透结合后，这些问题都能迎刃而解：无需申请公网 IP，就能让 Xiaomusic 服务暴露到外网，出差时在高铁上用手机就能远程给家里的小爱音箱点歌；cpolar 提供的固定二级子域名，不用每次重启设备都记新地址，日常使用更省心；而且穿透链路加密，不用担心小米账号或音乐文件信息泄露，同时手机、平板、电脑等多设备都能通过公网地址访问 Xiaomusic，不管是远程管理 NAS 歌单，还是给家里的小爱音箱发播放指令，都能打破局域网的限制，真正实现随时随地控制。
小爱音箱和家用NAS得绝配搭子，家里刚好有这两个设备的朋友赶紧省钱走起来吧！
准备好了吗？让我们一起把小爱音箱，变成属于你的私人音乐管家 ！
1.在极空间部署xiaomusic
1.1ssh远程连接到极空间
- 开启【SSH 服务】
- 使用终端（Windows PowerShell / Mac Terminal）登录：
ssh root@IP 没有ssh的小伙伴可以参考这篇文章：
连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ - cpolar 极点云官网
1.2验证docker是否开启
使用命令：
docker-v systemctl status -v没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ - cpolar 极点云官网
2.在极空间部署xiaomusic
使用docker部署的两种方式：
docker启动命令如下:
docker run -p58090:8090 -eXIAOMUSIC_PUBLIC_PORT=58090-v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic 对应的docker compose配置如下：
services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - 58090:8090 environment: XIAOMUSIC_PUBLIC_PORT: 58090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf 
部署完成后，在浏览器中输入 http://极空间IP:58090 就能看到xiaomusic的界面：
3.使用xiaomusic
选择“默认主题”进来后，点击设置：
输入你的小米账号及密码：
输入ip及端口：
往下滑，开启图中信息：
划到最下面，点击保存：
这时，划到最上面后，我们的设备就显示成功啦！
勾选设备后，还是划到最下面，点击保存后，回到首页：
这时我们的设备就添加成功了：
点击搜索，搜索我们想听的歌：
我这里搜索周杰伦：
后续也可以添加我们想听的歌：
点击测试，也可以播放链接的歌：
我们搜索的歌会在播放列表上，直接点击听就可以：
它还有很多主题供我们选择：
在完成XiaoMusic的 NAS 本地部署后，你已经可以让小爱音箱畅听局域网内的音乐了。但如果你想在外网远程控制家里的小爱音箱——比如在公司、在路上随时点歌回家播放，就需要将服务暴露到公网。这时，cpolar内网穿透工具就派上了大用场。无需公网IP、不用复杂端口映射，只需一条命令，cpolar就能将你 NAS 上运行的XiaoMusic 服务（默认端口58090）安全地映射为一个可外网访问的HTTPS链接，让你随时随地通过手机浏览器远程操控小爱音箱，真正实现“人在外，歌回家”的智能体验。
4.安装cpolar
cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤：
使用一键脚本安装命令：
sudocurl https://get.cpolar.sh |sh
安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）
sudo systemctl status cpolar 
Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：
打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。
5.配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：
- 隧道名称：可自定义，本例使用了:xiaomusic，注意不要与已有的隧道名称重复
- 协议：http
- 本地地址：58090
- 域名类型：随机域名
- 地区：选择China Top
创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。
访问成功。
6.保留固定公网地址
使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是xiaomusic，大家可以自定义。填写备注信息，点击保留。
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问极空间的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。
总结
Xiaomusic 搭配 cpolar 的组合，既解决了小爱音箱只能播放平台曲库的问题，又突破了局域网使用的局限，让本地音乐资源的利用更灵活。对于有 NAS 和小爱音箱的用户来说，这套方案操作简单、实用性强，能低成本提升家庭音乐使用体验，让本地音乐真正实现 “随心听、远程控”。
