XiaoMusic - 让小爱音箱变身私人音乐库

【创作声明】：本教程由人工智能生成，教程可行性已由作者本人进行确认核实。
手把手教你用Docker Compose部署XiaoMusic - 让小爱音箱变身私人音乐库

你是否厌倦了音乐平台的会员限制？想不想让小爱音箱播放你收藏的本地音乐？今天就来教大家通过Docker Compose轻松部署XiaoMusic，让小爱音箱焕发新生！

🎯 什么是XiaoMusic？

XiaoMusic是一个开源项目，能让你的小爱音箱直接播放NAS或本地存储的音乐，彻底摆脱音乐平台会员限制，打造专属音乐库！

📋 部署前准备

在开始之前，需要做好以下准备工作：

必需条件

1. 小米账号准备
   · 建议使用专门绑定小爱音箱的账号
   · 重要：如果账号开启了双重验证，请先在小米官网关闭
2. 网络环境
   · 确保小爱音箱和NAS/电脑在同一个WiFi网络下
   · 建议使用2.4G网络，稳定性更好
3. 创建存储目录
   在电脑或NAS上创建一个文件夹，比如：
   /docker/xiaomusic
   在这个文件夹里再创建两个子文件夹：
   music - 存放音乐文件
   conf - 存放配置文件

🚀 开始部署

步骤1：创建部署文件

在刚才创建的 /docker/xiaomusic 文件夹中，新建一个名为 docker-compose.yml 的文件，用文本编辑器打开，复制粘贴以下内容：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - "58090:8090"  # 左边58090可以改成其他数字，范围50000-60000
    volumes:
      - /docker/xiaomusic/music:/app/music   # 音乐存放目录
      - /docker/xiaomusic/conf:/app/conf     # 配置保存目录
    environment:
      # ↓↓↓ 必须修改！填写你NAS或电脑的IP地址 ↓↓↓
      - XIAOMUSIC_HOSTNAME=192.168.1.100
      # 搜索源设置，建议保持默认
      - XIAOMUSIC_SEARCH=bilisearch:
      # 如果上面端口改了，这里也要改成一样的
      - XIAOMUSIC_PUBLIC_PORT=58090

步骤2：修改关键配置

必须修改的地方：

1. IP地址：将 192.168.1.100 替换成你NAS的实际IP地址

2. 端口号（可选修改）：
   如果58090端口被占用，可以改成58091、58092等
   记得左右两边的端口号要保持一致

步骤3：docker-compose.yaml编辑完成后部署该项目

⚙️ 初始设置

访问管理界面

打开浏览器，输入：

http://你的NAS IP:58090

比如：http://192.168.1.100:58090

绑定账号和音箱

1. 进入设置页面
   点击页面上方的 "默认主题"
   点击底部导航栏的 "设置" 按钮
2. 填写账号信息
   输入你的小米账号和密码
   找到 "NAS的IP或域名" 和 "本地端口" 选项
   点击旁边的 "自动填写" 按钮（在输入框右边）
3. 开启目录监控
   建议开启"启用目录监控"选项
   这样新增音乐时会自动刷新
4. 保存并绑定音箱
   滚动到页面最底部，点击"保存"
   保存成功后，页面顶部会显示你的小爱音箱设备列表
   勾选要绑定的音箱
   再次滚动到底部点击"保存"
   最后点击 "返回首页"

🎵 使用方法

语音控制（最常用）

绑定成功后，直接对小爱音箱说：

"播放本地歌曲 [歌曲名]"
  示例："播放本地歌曲 晴天"
  示例："播放本地歌曲 周杰伦"
播放控制
  "下一首"
  "停止播放"
  "随机播放"
  "单曲循环"

网页端管理

在浏览器管理界面中，你可以：

· 搜索音乐：在搜索框输入歌名，搜索本地挂载音乐目录里的音乐
· 管理本地音乐：查看、播放已挂载的音乐
· 查看播放状态：实时显示当前播放的歌曲

💡 实用技巧

添加本地音乐

1. 将MP3等音乐文件复制到 /docker/xiaomusic/music 文件夹
2. 在Web界面点击刷新，或者开启目录监控自动刷新

批量添加音乐

可以直接将整个专辑文件夹拖到music目录中，系统会自动识别

❓ 常见问题

Q1: 登录失败怎么办？

· 确认账号密码正确
· 确保关闭了小米账号的双重验证
· 检查网络连接

Q2: 找不到小爱音箱设备？

· 在米家APP中退出账号再重新登录
· 回到XiaoMusic设置页面重新保存
· 等待1-2分钟再刷新页面

Q3: 音乐无法播放？

· 检查IP地址设置是否正确
· 确认小爱音箱和XiaoMusic在同一网络
· 查看防火墙是否阻挡了端口

Q4: 如何修改配置？

直接修改 docker-compose.yml 文件后，执行：

```bash
docker-compose down
docker-compose up -d
```

🎉 享受音乐时光

现在，你的小爱音箱已经成功升级为私人音乐库了！无论是怀旧老歌、小众音乐还是儿童故事，都可以随心播放，再也不用受会员限制困扰。

如果在部署过程中遇到任何问题，欢迎在评论区留言，我会尽力帮助大家解决！

---

温馨提示：请尊重音乐版权，建议播放自己购买或拥有合法授权的音乐文件。

这个好用，可以直接拉歌单了

牛逼牛逼

[+] Running 1/1
✘ xiaomusic Error Get "https://registry-1.docker.io/v...                 15.0s
Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

一直报错

收藏先，谢谢！

为什么我的日志提示登录失败啊，账号id和密码明明没有问题，也没开启二次绑定

aFkNTg 发表于 2025-11-25 16:14
为什么我的日志提示登录失败啊，账号id和密码明明没有问题，也没开启二次绑定 ...

可以看一下官方文档 大部分音箱是支持的 有少量不支持 pro是完美适配的

我的音响和nas不在一个局域网可以吗？

ETO 发表于 2025-11-27 12:45
可以看一下官方文档 大部分音箱是支持的 有少量不支持 pro是完美适配的

我查了一下，LX05在支持设备名单里面啊

                               
登录/注册后可看大图

学习了，谢谢