文章目录前言1.在极空间部署xiaomusic1.1ssh远程连接到极空间1.2验证docker是否开启2.在极空间部署xiaomusic3.使用xiaomusic4.安装cpolar5.配置公网地址6.保留固定公网地址总结前言XiaoMusic是一个开源的小爱音箱本地音乐播放工具通过NAS部署之后可以让小爱音箱直接播放本地曲库不走QQ音乐、网易云那些网络曲库也就不受会员权限限制。本质上是个局域网音乐服务器加语音控制前端的组合开发者把交互层做得比较完整配好账号之后用小爱同学语音点歌的体验和正常用网络曲库差不多。这类需求在小米生态里其实一直存在——官方对本地音乐的支持比较弱DLNA投放的体验也不算流畅XiaoMusic等于是在这个缺口上补了一个开源方案。部署方式主流就是Docker写好docker-compose配好端口映射和持久化目录二十分钟以内能跑起来。群晖、极空间、威联通这几家适配都没问题核心步骤就是下载镜像、建配置目录、启动容器。用下来最顺手的地方是语音唤醒的流畅度——基本和用网络曲库的感觉一致想听什么直接喊比打开手机找歌再投屏那套流程省事。曲库管理靠的是在NAS目录里放歌文件夹怎么组织、要不要建歌单都是自己定没有平台那种版权歌曲下架的破事。主题界面有好几套换肤这个属于锦上添花不算核心功能。局限也有目前登录用的是小米账号第三方授权token过期要重新登录家庭账号共享逻辑官方没有做多人使用的话每个人配自己的设备绑定更稳。1.在极空间部署xiaomusic1.1ssh远程连接到极空间开启【SSH 服务】使用终端Windows PowerShell / Mac Terminal登录sshrootIP没有ssh的小伙伴可以参考cpolar官网的《极空间别再吃灰了开启SSH秒变全能服务器》这篇文章。1.2验证docker是否开启使用命令docker-vsystemctl status-v没有docker的小伙伴可以参考cpolar官网的《极空间开箱实录从拆箱到远程访问保姆级教程30分钟上手》这篇文章。2.在极空间部署xiaomusic使用docker部署的两种方式docker启动命令如下:dockerrun-p58090:8090-eXIAOMUSIC_PUBLIC_PORT58090-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:58090volumes: - /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.安装cpolarcpolar 可以将你本地电脑中的服务如 SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudosystemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机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点击更新更新完成后打开在线隧道列表此时可以看到随机的公网地址已经发生变化地址名称也变成了保留和固定的二级子域名名称。最后我们使用固定的公网地址在任意设备的浏览器中访问可以看到成功访问极空间的页面这样一个永久不会变化的二级子域名公网网址即设置好了。总结整套方案适合家里有小爱音箱、NAS里有本地音乐囤着、对版权平台的依赖比较烦了、想折腾一个自己可控的音乐播放方案的用户。不适合追求海量网络曲库、懒得折腾配置的。部署完之后基本上属于配一次长期用的那种稳定性和网络宽带条件关系比较大。