极空间部署XiaoMusic：把NAS里的本地音乐接入小爱音箱，搜索、播放和远程控制一起完成
前言
家里已经有小爱音箱，也已经在NAS里存了一堆自己的音乐，真正麻烦的是这两套东西通常是分开的：音乐躺在硬盘里，小爱音箱却主要还是围着在线曲库工作，想播放自己保存的歌曲并不顺手。
XiaoMusic解决的就是这类问题。它把NAS里的本地音乐和小爱音箱连接起来，让已经保存好的歌曲可以继续通过网页管理、搜索和播放，再把对应设备加入进来。
这篇会先在极空间NAS上通过Docker运行XiaoMusic，再填写小米账号、IP和端口，把小爱音箱接入系统，随后实际搜索歌曲、加入播放列表并测试播放。
这样NAS就不只是"存音乐"，而开始承担家庭音乐库的角色；小爱音箱也不再只依赖原来的在线曲库，而是能够继续播放自己保存在NAS里的内容。
如果只在家里使用，到局域网控制已经够用；如果还希望人在公司、路上或其他网络环境中远程打开XiaoMusic控制页面，后半段再通过cpolar增加公网入口和固定地址。整篇真正跑的是NAS保存音乐 → XiaoMusic管理和播放 → 小爱音箱接入 → 搜索与播放本地歌曲 → 需要时远程控制这条链。
1.在极空间部署xiaomusic
1.1ssh远程连接到极空间
- 开启【SSH 服务】
- 使用终端（Windows PowerShell / Mac Terminal）登录：
shell
ssh root@IP没有ssh的小伙伴可以参考cpolar官网的《极空间别再吃灰了！开启SSH，秒变全能服务器！》这篇文章。
1.2验证docker是否开启
使用命令：
shell
docker -v
systemctl status -v没有docker的小伙伴可以参考cpolar官网的《极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！》这篇文章。
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中的音乐。如果还希望人在外面通过手机或其他电脑打开控制页面，就需要再给本地的XiaoMusic服务增加一个外部访问入口。
这里继续使用cpolar，把运行在NAS上的XiaoMusic Web页面映射到公网，后续就可以从其他网络环境继续搜索歌曲、查看播放列表和控制家里的小爱音箱。
4.安装cpolar
cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤：
使用一键脚本安装命令：
shell
sudo curl https://get.cpolar.sh | sh
安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）
shell
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
创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。
公网地址能够正常打开以后，说明XiaoMusic控制页面已经可以从其他网络环境访问。
6.保留固定公网地址
使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是xiaomusic，大家可以自定义。填写备注信息，点击保留。
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理------隧道列表，找到所要配置的隧道，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后使用固定公网地址再次访问，确认XiaoMusic页面仍然可以正常打开，这样长期远程控制时就不需要反复更换访问地址。
总结
这篇真正完成的，不只是把XiaoMusic容器跑在极空间NAS上，而是把NAS里的本地音乐和小爱音箱真正接到了一起。
前半段先通过Docker运行XiaoMusic，再填写小米账号和相关连接信息，把家里的小爱设备加入系统。随后通过搜索、播放列表和播放测试，确认NAS里的音乐可以继续通过XiaoMusic进行管理和播放。
这样NAS负责长期保存自己的音乐文件，XiaoMusic负责搜索、列表和播放控制，小爱音箱负责实际发声。原本分开的"本地音乐库"和"智能音箱"开始形成一套完整的家庭播放链路。
后半段的cpolar解决的是控制范围问题：局域网里已经能正常使用以后，再把XiaoMusic页面扩展到外部网络，并通过固定地址长期访问。最终得到的不是一个单纯的NAS容器，而是一套可以长期保存、管理并通过小爱音箱播放自己音乐的家庭音乐系统。