蒙国造博客

xiaomusic 安装、配置和使用教程，免费用小爱音箱无限播放音乐

Gary

第一步 安装 xiaomusic

在和小米AI音箱同一个网络里面的任何一台机器，NAS或者电脑都行，安装上docker。

然后用 docker 启动 xiaomusic，当然你也可以用别的方式。

我们这里用 docker compose 启动，最简单。

 services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090
    environment:
      XIAOMUSIC_HOSTNAME: 192.168.1.100
      XIAOMUSIC_PUBLIC_PORT: 58090
    volumes:
      - ./xiaomusic_music:/app/music
      - ./xiaomusic_conf:/app/conf

这里 `192.168.1.100` 就是安装xiaomusic的那台机器的内网IP（不是docker容器的IP）。

然后启动：

docker compose up

第二步 配置账号

访问 http://192.168.1.100，

然后在设置页面填入你的小米账号和密码，在拉到最下面点【保存】按钮保存。

然后在同一个页面的最顶端就能看到你的小米音箱了，勾选他再点【保存】。

第三步 错误 invalid admin

如果遇到这个错误：

xiaomusic  | [2025-02-15 02:51:21] [0.3.74] [ERROR] xiaomusic.py:1866: Execption Error https://api2.mina.mi.com/remote/ubus: {'code': 1, 'message': 'invalid admin', 'data': None}
xiaomusic  | Traceback (most recent call last):
xiaomusic  |   File "/app/xiaomusic/xiaomusic.py", line 1856, in text_to_speech
xiaomusic  |     await self.xiaomusic.mina_service.text_to_speech(self.device_id, value)
xiaomusic  |   File "/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py", line 66, in text_to_speech
xiaomusic  |     return await self.ubus_request(
xiaomusic  |   File "/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py", line 59, in ubus_request
xiaomusic  |     result = await self.mina_request(
xiaomusic  |   File "/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py", line 49, in mina_request
xiaomusic  |     return await self.account.mi_request(
xiaomusic  |   File "/app/.venv/lib/python3.10/site-packages/miservice/miaccount.py", line 150, in mi_request
xiaomusic  |     raise Exception(f"Error {url}: {resp}")
xiaomusic  | Exception: Error https://api2.mina.mi.com/remote/ubus: {'code': 1, 'message': 'invalid admin', 'data': None}

返回设置页面，设置【型号兼容模式:】为true。

退出移动版