---
title: xiaomusic极空间安装教程（2024/12/4更新）
---
# xiaomusic极空间安装教程（2024-12-4更新）
> 本教程同步更新于最新版的xiaomusic
看不懂/嫌麻烦/懒 但有点小钱，找 hanxi 预约微信或者 QQ 远程安装，他便宜，收费50一次，作法不成功不要钱
**ARM架构自己想办法获取镜像 点名Z2PRO**
# 获取镜像
## 科学环境：
1. 在 **搜索框** 中输入 `hanxi/xiaomusic`，在搜索的结果中直接选择第一个，点击**下载**
2. 在新弹出的版本选择窗口中，根据你的情况选择。
### 版本说明
- 获取 **最新版** 直接点击 **下载** 即可，建议使用默认的 `latest`
- 获取 **特定版本** [点击此处可查看](https://github.com/hanxi/xiaomusic/releases) 用于回退出现功能不兼容、恶性bug等情况，一般建议反馈开发者，修复很及时，尽量不要回退版本 请输入如 `v0.3.55`
- 获取 **实验版本**（已修复部分bug但未推送）请输入 `main`
3. 接着弹出如图所示的页面，耐心等待下载完成。
4. 下载完成后切换到 **本地镜像** 选项卡
剩余步骤与国内环境相同，见 [部署镜像](#部署镜像)
## 国内环境：
1. 打开docker，在左侧的菜单中选择 **镜像** 切换到 **仓库** 选项卡，点击 **自定义拉取** 按钮
2. 在弹出的对话框中输入 ` m.daocloud.io/docker.io/hanxi/xiaomusic ` ，点击 **拉取** 按钮
3. 下载完成后切换到 **本地镜像** 选项卡
# 部署镜像
1. 找到刚才已经拉取好的镜像，*单击选中*，点击 **添加到容器**
2. 在弹出的 **创建容器** 菜单中，切换到 **文件夹路径** 选项卡中，按图中的提示进行配置。
**注意：**
* 装载路径中的 **配置文件目录** 和 **音乐目录** 必须进行配置。
* 如有多个音乐目录，请按照下面的格式进行配置
| 文件/文件夹 | 装载路径 |
| :----------: | :----------: |
| /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. 回到首页，出现设备列表，切换对应设备即可畅享
## 评论
### 评论 1 - xiaohuobanhahaha
[xiaomusic.txt](https://github.com/user-attachments/files/18011572/xiaomusic.txt)
an'zh
无法使用语音播放歌曲，小爱s12a。极空间z4pro。
1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090.
2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传
---
### 评论 2 - 52fisher
> [xiaomusic.txt](https://github.com/user-attachments/files/18011572/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](https://github.com/user-attachments/files/18012369/xiaomusic.txt)
---
### 评论 6 - 52fisher
> 可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， [xiaomusic.txt](https://github.com/user-attachments/files/18012369/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](https://github.com/user-attachments/files/18012369/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](https://github.com/hanxi/xiaomusic?tab=readme-ov-file#-%E8%AE%A8%E8%AE%BA%E5%8C%BA)
---
### 评论 11 - xiaohuobanhahaha
> >
> > > > 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。
> > >
> > >
> > > 容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧
> >
> >
> > 辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。
>
> [readme](https://github.com/hanxi/xiaomusic?tab=readme-ov-file#-%E8%AE%A8%E8%AE%BA%E5%8C%BA)
已自查解决。问题是账号问题。绑定设备的一定是创建者，不能是管理员。
---
[链接到 GitHub Issue](https://github.com/hanxi/xiaomusic/issues/297)