XiaoMusic 零基础快速上手指南30 分钟让小爱音箱播放你的私人音乐库【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你有没有幻想过这样的场景瘫在沙发上随口说一句播放周杰伦的晴天小爱音箱就立刻响起熟悉的旋律XiaoMusic 正是实现这个幻想的开源项目——它的核心功能是让小爱音箱播放你的音乐库还能用 yt-dlp 自动下载在线歌曲。全程只需浏览器和几条命令不需要写一行代码。动手前先搞懂 3 件事原理、装备、用时它到底是怎么工作的一句话讲透XiaoMusic 是个翻译官。你说话 → 小爱音箱听懂 → 通过小米服务把指令转给 XiaoMusic → 它去本地音乐库或在线资源找歌 → 再推回音箱播放。你只需在后台配置一次剩下的全靠嘴。你需要准备什么一台小爱音箱市面主流型号基本都支持L06A、L05C、LX06、Xiaomi Sound 等都在支持列表里一台能跑 Docker 的设备NAS、闲置电脑、软路由都行一个小米账号确保已绑定你的音箱一些音乐文件可选没有也能在线点歌大概要多久顺利的话 15~30 分钟从零到能听歌。下面的每一步我都标了成功标志走一步确认一步不迷路。第一步准备两个目录把音乐库喂给容器Docker 容器是个隔离舱默认看不见你主机上的文件。所以要先在外面建两个目录再通过挂载把音乐送进去mkdir -p /xiaomusic_music /xiaomusic_conf/xiaomusic_music音乐文件的家支持mp3、flac、wav、ape、ogg、m4a六种格式/xiaomusic_conf存放 XiaoMusic 的配置文件和日志把喜欢的歌拷进音乐目录。建议按文件夹分类比如建周杰伦轻音乐子目录这些文件夹就是你的歌单。暂时没有歌也没关系先往后走在线点歌一样能玩。✅ 成功标志执行ls /xiaomusic_music能看到你的文件或至少是个空目录——之后在线下载的歌也会落在这里。第二步一条 docker-compose 配置一键拉起服务新建文件docker-compose.yml内容如下。国内网络建议用国内镜像拉取更快services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf58090:8090宿主机 58090 端口映射到容器 8090之后浏览器访问http://你的设备IP:58090restart: always设备重启后自动拉起服务省心然后启动docker compose up -d✅ 成功标志docker ps里能看到xiaomusic容器处于Up状态。首次启动要拉镜像等 1~2 分钟属正常别急着关终端。第三步进 Web 后台把小米账号绑上音箱浏览器打开http://你的设备IP:58090你会看到一个清爽的管理界面。这一步是整个部署里唯一的动手配置环节进入账号设置填入小米账号和密码带*号的配置是必填项保存等待系统拉取设备列表刷新页面勾选你家的那台小爱音箱再次保存确认✅ 成功标志设备列表里出现你的音箱型号勾选保存后无报错。这一步过了后面全是水到渠成。第四步开口点歌让整条链路跑起来一切就绪现在试试这些魔法口令你说什么音箱做什么播放歌曲晴天搜索本地音乐库并播放播放歌单周杰伦播放周杰伦文件夹里的歌下一首 / 上一首切换歌曲单曲循环 / 随机播放切换播放模式在线播放周杰伦的晴天用 yt-dlp 在线搜歌下载后播放加入收藏收藏当前歌曲30分钟后关机定时关闭音箱✅ 成功标志音箱开口唱歌。哪怕本地一首歌都没有在线播放也能让音箱立刻响起来——这是 XiaoMusic 最让人惊喜的地方只要你说得出歌名它就去找来放。 隐藏彩蛋对小爱说播放歌曲小猪佩奇的故事它会先把故事下载好再播放家里有娃的可以试试。小贴士在线播放依赖 yt-dlp 访问下载源国内网络偶尔会慢或失败去设置里配一个代理就能解决下文细说。第五步再调 3 个设置把体验直接拉满① 自定义语音口令默认口令播放歌曲用不惯去设置页把播放歌曲改成来一首把停止播放改成别唱了。让小爱说你的语言而不是你迁就它的模板。② 开启转换为 MP3如果你的音箱是 L05B、L05C、LX06、L16A 这些老型号它们不认 flac 无损格式。开启转换为 MP3后XiaoMusic 会在播放前自动转码彻底告别歌在库里却放不出来的玄学问题。③ 配置定时任务想每天早上 7 点被音乐叫醒在设置里填一行定时任务配置XiaoMusic 到点自动开播相当于给音箱装了个闹钟 DJ二合一。新手最常踩的 4 个坑提前帮你填平Q1设备列表里找不到我的音箱排查思路确认账号密码无误 → 确认音箱和部署设备在同一局域网→ 确认音箱已绑定在当前小米账号下 → 刷新页面重试。还不行就重启容器再来一次。Q2说播放歌曲xxx完全没反应排查思路先到 Web 后台的播放列表里看这首歌在不在。本地音乐只认music目录下的文件歌名太模糊时试试播放本地歌曲 完整歌名。再看容器日志docker logs xiaomusic能直接看到 XiaoMusic 收到了什么指令、匹配到了什么——这是最有效的排错方式。Q3flac 文件放不出来多半是音箱不支持无损格式。去设置里打开转换为 MP3保存后问题即消。Q4在线点歌很慢甚至直接失败在线下载要靠 yt-dlp 访问网络源国内网络波动大。在设置里配好代理proxy再试速度立竿见影。⚠️安全提醒如果把服务暴露到公网务必开启 HTTP 认证并设置强密码。另外别把音箱的小米账号绑定摄像头——账号一旦泄露风险会被无限放大。写在最后从会用到会玩XiaoMusic 最动人的地方是把听歌从拿起手机找歌单变回了开口就来。科技的意义不就是让人更懒一点、更爽一点吗接下来你还可以去 Web 后台研究网络歌单、收藏夹和播放器主题把界面调成自己喜欢的样子想从源码折腾克隆仓库git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic按 README 的开发指南跑起来把这个技巧分享给身边也有小爱音箱的朋友一起解锁动口不动手的听歌姿势祝你和小爱同学相处愉快从此好歌不断档【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考