xiaomusic极空间安装教程（2024/12/28更新）

[52fisher]

本教程同步更新于最新版的xiaomusic

看不懂/嫌麻烦/懒 但有点小钱，找 hanxi 预约微信或者 QQ 远程安装，他便宜，收费50一次，作法不成功不要钱

ARM架构自己想办法获取镜像 点名Z2PRO

获取镜像

科学环境：

1. 在 搜索框 中输入 hanxi/xiaomusic，在搜索的结果中直接选择第一个，点击下载

2. 在新弹出的版本选择窗口中，根据你的情况选择。
   

版本说明

• 获取 最新版 直接点击 下载 即可，建议使用默认的 latest
• 获取 特定版本 点击此处可查看 用于回退出现功能不兼容、恶性bug等情况，一般建议反馈开发者，修复很及时，尽量不要回退版本 请输入如 v0.3.55
• 获取 实验版本（已修复部分bug但未推送）请输入 main

3. 接着弹出如图所示的页面，耐心等待下载完成。
   

4. 下载完成后切换到 本地镜像 选项卡

剩余步骤与国内环境相同，见 部署镜像

国内环境：

1. 打开docker，在左侧的菜单中选择 镜像 切换到 仓库 选项卡，点击 自定义拉取 按钮
   
2. 在弹出的对话框中输入 m.daocloud.io/docker.io/hanxi/xiaomusic ，点击 拉取 按钮
   
3. 下载完成后切换到 本地镜像 选项卡

部署镜像

1. 找到刚才已经拉取好的镜像，单击选中，点击 添加到容器
   
2. 在弹出的 创建容器 菜单中，切换到 文件夹路径 选项卡中，按图中的提示进行配置。
   

注意：

• 装载路径中的 配置文件目录 和 音乐目录 必须进行配置，其他目录非必要请勿配置
• 主题目录为方便开发主题调试时的配置选项，普通用户不能理解明确用途请不要配置主题目录，否则会报HTTP Status 500 – Internal Server Error 错误
• 如有多个音乐目录，请按照下面的格式进行配置

文件/文件夹	装载路径
/data/music1	/app/music/music1
/data/music2	/app/music/music2

3. 切换到 端口 选项卡，修改成与你的极空间 不冲突 的本地端口号，如 5678 （示例按照本地端口号5678来进行配置，下同）

友情提醒: 尽量不要修改容器端口号，否则要到配置文件目录修改对应的setting.json文件中的配置，会增加很多麻烦

5. 切换到 环境 选项卡，将XIAOMUSIC_HOSTNAME 修改为你的 极空间的IP地址

友情提醒：

1. 此处不可忽略，否则后续播放音乐会出现问题
2. 不要尝试修改XIAOMUSIC_PORT！除非你没有看上一条的友情提醒
3. 不要在此处配置ACCOUNT和PASSWORD，没有过风控仍然无法使用！上古时代的教程不要再看了，容易走火入魔！

6. 点击 应用按钮，此时容器已经配置完成了，切换到左侧的 容器概况 菜单，可查看容器详情
   

进入xiaomusic网页端进行配置

1.请关闭代理，打开浏览器，地址栏输入 极空间IP:本地端口号 如192.168.2.5:5678，打开网页后点击 默认主题

注意：

• 不要复制此处的地址，必须输入极空间的IP地址。不知道的建议上咸鱼50块换个不锈钢盆
• 不要输入容器的端口号8090，极空间不能使用这个端口号。

2. 点击 设置 按钮进入设置页面
   

3. 输入小米账号、小米密码、XIAOMUSIC_HOSTNAME(IP或域名):、外网访问端口，滑到页面最下方点击 保存
   
   

注意:

• 小米账号非手机号，请在手机设置-个人中心中查看小米ID
• 密码不要输错，账号密码错误在上面会弹出提醒，不要假装看不见上面的提醒文字
• XIAOMUSIC_HOSTNAME(IP或域名): 可以输入当前页面的IP地址（在地址栏），不要在此处输入端口号！！！，如果域名需要使用https协议，请加上https://

4.如果以上步骤没错，你将在设置中心看见设备列表

5. 回到首页，出现设备列表，切换对应设备即可畅享
   

[xiaohuobanhahaha]

xiaomusic.txt

an'zh 无法使用语音播放歌曲，小爱s12a。极空间z4pro。 1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090. 2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传

[52fisher]

xiaomusic.txt
an'zh 无法使用语音播放歌曲，小爱s12a。极空间z4pro。 1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090. 2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传

既然你映射的5678，为什么你又在那把监听端口改成11999? 我的教程里面全程没有写要修改监听端口

[xiaohuobanhahaha]

我没讲清楚。我试了两种极空间的桥接和host模式。桥接模式。我按照教程走的。报错如图

提到的第二个问题和日志，是我将网络模式改为host的情况，能连上音箱，但是没法使用语音控制。

[52fisher]

我没讲清楚。我试了两种极空间的桥接和host模式。桥接模式。我按照教程走的。报错如图

提到的第二个问题和日志，是我将网络模式改为host的情况，能连上音箱，但是没法使用语音控制。

把外网访问端口改成5678

[xiaohuobanhahaha]

可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。
这是日志，
xiaomusic.txt

[52fisher]

可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， xiaomusic.txt

你的设置 hostname='192.168.31.165', port=8090, public_port=5678,
后台的ip 192.168.31.143 检查一下你的地址 有可能是你的ip地址改变了

[xiaohuobanhahaha]

可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， xiaomusic.txt

你的设置 hostname='192.168.31.165', port=8090, public_port=5678, 后台的ip 192.168.31.143 检查一下你的地址 有可能是你的ip地址改变了

确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。

[52fisher]

确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。

容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧

[xiaohuobanhahaha]

确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。

容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧

辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。

[52fisher]

确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。

容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧

辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。

readme

[xiaohuobanhahaha]

确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。

容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧

辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。

readme

已自查解决。问题是账号问题。绑定设备的一定是创建者，不能是管理员。

[McCree2020]

这个主题目录不能设置吧？没人遇到这个issue？我原来用的张大妈平台的教程设置的，能用，后来看到这个教程后就修改了后台的路径映射，但是dockers启动正常，网页不能打开提示internal sever error，后来ssh进docker看了日志文件 提示static那个路径有问题，下边的index什么的文件找不到， 删除主题映射以后，重启docker后，网页正常显示了

[52fisher]

这个主题目录不能设置吧？没人遇到这个issue？我原来用的张大妈平台的教程设置的，能用，后来看到这个教程后就修改了后台的路径映射，但是dockers启动正常，网页不能打开提示internal sever error，后来ssh进docker看了日志文件 提示static那个路径有问题，下边的index什么的文件找不到， 删除主题映射以后，重启docker后，网页正常显示了

要注意看提示：
装载路径中的 配置文件目录 和 音乐目录 必须进行配置。

其他的路径非必要不要配置，主题目录路径是方便开发调试的时候用的，普通用户不要映射主题目录。我已经把这个提示更新到文档中了

[zxhans]

就不能让xiaomusic支持服务器部署吗？服务器部署为啥设备不能读取呢？home assistant 通过xiaomi home assistant都可以读取呀

[hanxi]

就不能让xiaomusic支持服务器部署吗？服务器部署为啥设备不能读取呢？home assistant 通过xiaomi home assistant都可以读取呀

支持服务器部署的，你需要在服务器上装个浏览器登陆过风控。