xiaomusic极空间安装教程（2024-12-28更新） 本教程同步更新于最新版的xiaomusic
看不懂/嫌麻烦/懒 但有点小钱，找 hanxi 预约微信或者 QQ 远程安装，他便宜，收费50一次，作法不成功不要钱
ARM架构自己想办法获取镜像 点名Z2PRO
获取镜像 科学环境： 在 搜索框 中输入 hanxi/xiaomusic，在搜索的结果中直接选择第一个，点击下载
在新弹出的版本选择窗口中，根据你的情况选择。 版本说明 获取 最新版 直接点击 下载 即可，建议使用默认的 latest获取 特定版本 点击此处可查看 用于回退出现功能不兼容、恶性bug等情况，一般建议反馈开发者，修复很及时，尽量不要回退版本 请输入如 v0.3.55获取 实验版本（已修复部分bug但未推送）请输入 main接着弹出如图所示的页面，耐心等待下载完成。
下载完成后切换到 本地镜像 选项卡
剩余步骤与国内环境相同，见 部署镜像
国内环境： 打开docker，在左侧的菜单中选择 镜像 切换到 仓库 选项卡，点击 自定义拉取 按钮 在弹出的对话框中输入 m.daocloud.io/docker.io/hanxi/xiaomusic ，点击 拉取 按钮 下载完成后切换到 本地镜像 选项卡部署镜像 找到刚才已经拉取好的镜像，单击选中，点击 添加到容器在弹出的 创建容器 菜单中，切换到 文件夹路径 选项卡中，按图中的提示进行配置。 注意：
装载路径中的 配置文件目录 和 音乐目录 必须进行配置，其他目录非必要请勿配置主题目录为方便开发主题调试时的配置选项，普通用户不能理解明确用途请不要配置主题目录，否则会报HTTP Status 500 – Internal Server Error 错误如有多个音乐目录，请按照下面的格式进行配置文件/文件夹装载路径/data/music1/app/music/music1/data/music2/app/music/music2切换到 端口 选项卡，修改成与你的极空间 不冲突 的本地端口号，如 5678 （示例按照本地端口号5678来进行配置，下同）友情提醒: 尽量不要修改容器端口号，否则要到配置文件目录修改对应的setting.json文件中的配置，会增加很多麻烦
切换到 环境 选项卡，将XIAOMUSIC_HOSTNAME 修改为你的 极空间的IP地址友情提醒：
此处不可忽略，否则后续播放音乐会出现问题不要尝试修改XIAOMUSIC_PORT！除非你没有看上一条的友情提醒不要在此处配置ACCOUNT和PASSWORD，没有过风控仍然无法使用！上古时代的教程不要再看了，容易走火入魔！
点击 应用按钮，此时容器已经配置完成了，切换到左侧的 容器概况 菜单，可查看容器详情 进入xiaomusic网页端进行配置 1.请关闭代理，打开浏览器，地址栏输入 极空间IP:本地端口号 如192.168.2.5:5678，打开网页后点击 默认主题
注意：
不要复制此处的地址，必须输入极空间的IP地址。不知道的建议上咸鱼50块换个不锈钢盆不要输入容器的端口号8090，极空间不能使用这个端口号。点击 设置 按钮进入设置页面
输入小米账号、小米密码、XIAOMUSIC_HOSTNAME(IP或域名):、外网访问端口，滑到页面最下方点击 保存
注意:
小米账号非手机号，请在手机设置-个人中心中查看小米ID密码不要输错，账号密码错误在上面会弹出提醒，不要假装看不见上面的提醒文字XIAOMUSIC_HOSTNAME(IP或域名): 可以输入当前页面的IP地址（在地址栏），不要在此处输入端口号！！！，如果域名需要使用https协议，请加上https://4.如果以上步骤没错，你将在设置中心看见设备列表
回到首页，出现设备列表，切换对应设备即可畅享 评论 评论 1 - xiaohuobanhahaha xiaomusic.txt
an'zh 无法使用语音播放歌曲，小爱s12a。极空间z4pro。 1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090. 2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传 评论 2 - 52fisher xiaomusic.txt an'zh 无法使用语音播放歌曲，小爱s12a。极空间z4pro。 1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090. 2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传
既然你映射的5678，为什么你又在那把监听端口改成11999? 我的教程里面全程没有写要修改监听端口
评论 3 - xiaohuobanhahaha 我没讲清楚。我试了两种极空间的桥接和host模式。桥接模式。我按照教程走的。报错如图
提到的第二个问题和日志，是我将网络模式改为host的情况，能连上音箱，但是没法使用语音控制。
评论 4 - 52fisher 我没讲清楚。我试了两种极空间的桥接和host模式。桥接模式。我按照教程走的。报错如图
提到的第二个问题和日志，是我将网络模式改为host的情况，能连上音箱，但是没法使用语音控制。
把外网访问端口改成5678
评论 5 - xiaohuobanhahaha 可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， xiaomusic.txt
评论 6 - 52fisher 可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， xiaomusic.txt
你的设置 hostname='192.168.31.165', port=8090, public_port=5678, 后台的ip 192.168.31.143 检查一下你的地址 有可能是你的ip地址改变了
评论 7 - 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都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
评论 8 - 52fisher 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧
评论 9 - xiaohuobanhahaha 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧
辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。
评论 10 - 52fisher
确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧
辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。
readme
评论 11 - xiaohuobanhahaha
确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧
辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。
readme
已自查解决。问题是账号问题。绑定设备的一定是创建者，不能是管理员。
评论 12 - McCree2020 这个主题目录不能设置吧？没人遇到这个issue？我原来用的张大妈平台的教程设置的，能用，后来看到这个教程后就修改了后台的路径映射，但是dockers启动正常，网页不能打开提示internal sever error，后来ssh进docker看了日志文件 提示static那个路径有问题，下边的index什么的文件找不到， 删除主题映射以后，重启docker后，网页正常显示了
评论 13 - 52fisher 这个主题目录不能设置吧？没人遇到这个issue？我原来用的张大妈平台的教程设置的，能用，后来看到这个教程后就修改了后台的路径映射，但是dockers启动正常，网页不能打开提示internal sever error，后来ssh进docker看了日志文件 提示static那个路径有问题，下边的index什么的文件找不到， 删除主题映射以后，重启docker后，网页正常显示了
要注意看提示： 装载路径中的 配置文件目录 和 音乐目录 必须进行配置。
其他的路径非必要不要配置，主题目录路径是方便开发调试的时候用的，普通用户不要映射主题目录。我已经把这个提示更新到文档中了
评论 14 - zxhans 就不能让xiaomusic支持服务器部署吗？服务器部署为啥设备不能读取呢？home assistant 通过xiaomi home assistant都可以读取呀
评论 15 - hanxi 就不能让xiaomusic支持服务器部署吗？服务器部署为啥设备不能读取呢？home assistant 通过xiaomi home assistant都可以读取呀
支持服务器部署的，你需要在服务器上装个浏览器登陆过风控。
评论 16 - Lunder-R
确实是变了。192.168.31.143是我电脑的ip。hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主dhcp都绑定了。大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
容器的网络模式改成桥试用呢没解决的话你加群明天再详聊吧
辛苦了，今天晚上还在回复。我一直用的桥。大佬，群号多少，不行我明天群里问吧。
自述
自查解决。问题是已账号问题。绑定设备的一定是创建者，不能是管理员。
能不能分享一下解决大概过程，我也是这种情况，谢谢了
链接到 GitHub Issue