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）登录：

shell 复制代码

ssh root@IP

没有ssh的小伙伴可以参考这篇文章：

连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ - cpolar 极点云官网

1.2验证docker是否开启

使用命令：

shell 复制代码

docker -v 
systemctl status -v

没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ - cpolar 极点云官网

2.在极空间部署xiaomusic

使用docker部署的两种方式：

docker启动命令如下:

shell 复制代码

docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

对应的docker compose配置如下：

shell 复制代码

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链接，让你随时随地通过手机浏览器远程操控小爱音箱，真正实现"人在外，歌回家"的智能体验。