小爱音箱如何语音播放你的私人音乐库Docker 一键部署 XiaoMusic 零基础指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic周末午后你瘫在沙发里想听点真正合胃口的歌——不是音箱算法硬塞的热门曲而是你这些年一张张攒下的无损收藏。可要播它们你得先掏手机、翻歌单、连蓝牙中途还总被消息打断。有没有可能直接喊一声就好XiaoMusic 就是干这个的开源项目用 Docker 部署、绑定小米账号后小爱音箱能听懂播放周杰伦的晴天这类口令从本地音乐库或在线平台找歌、下载、播放全程不碰手机。先看一眼终点部署成功后的一天我们把时间拨到部署完成后的第一个周末你的一天会是这样清晨对小爱说播放歌单晨间咖啡三秒后音箱响起你自己整理好的歌单通勤路上用手机浏览器打开管理界面随手把刚下载的新歌加进收藏晚上瘫在沙发上喊一句随机播放音乐顺序被打乱像有人替你按了洗牌键想安静时一句停止播放它回一句收到再见干脆利落。上面这张图就是后台管理界面左侧是设备、播放列表、设置等入口中间是当前歌曲、进度条和播放控制按钮右侧是音量。也就是说小爱听懂你的话但你能用眼睛看到一切、用手微调一切。至于它怎么听懂你用个笨比喻XiaoMusic 像一位蹲在你家路由器旁边的翻译兼调度员——它监听小爱的对话记录把播放××翻译成指令去你的音乐文件夹里翻歌再通过小米服务把歌推回音箱。这套逻辑的源码在 xiaomusic/command_handler.py有兴趣随时翻。四小步把服务跑起来部署路径其实很短我把它切成四小步每步做完都有看得见的反馈你不会卡在不知道进行到哪一步的迷茫里。第 1 步给音乐和配置各腾一个抽屉先在部署设备NAS、软路由或旧电脑都行上建两个目录一个放歌一个放配置mkdir -p /xiaomusic_music /xiaomusic_conf做完这一步你会得到两个空文件夹外加一种我已经开始动手了的踏实感。为什么要分开音乐和配置各自独立以后备份配置、迁移硬盘、整体搬家都只用动一个文件夹。音乐是你多年攒下的资产配置是你调好的口令和账号信息别让它们混在一个抽屉里。第 2 步写一份只有 9 行的启动文件新建一个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/conf人话翻译一下这几个关键行配置它管什么别动什么58090:809058090 是开在你设备这边的门浏览器靠它访问冒号右边的 8090 是容器内部的房间号别改两个volumes把上一步的两个文件夹接进容器冒号右边的/app/music、/app/conf是容器内部路径保持原样restart: always断电重启后服务自动复活—镜像地址用的是国内镜像站拉取速度更快如果你的网络访问 Docker Hub 毫无压力把镜像名换成hanxi/xiaomusic也一样。做完这一步你会得到一份能自愈的启动脚本设备重启后小爱音箱的音乐服务会自动回来不用你半夜爬起来手动拉起来。第 3 步一条命令唤醒容器在docker-compose.yml所在目录执行docker compose up -d等待镜像下载完成取决于网速通常几分钟。然后确认它活着docker ps | grep xiaomusic看到状态是Up就说明成了。这时打开浏览器访问http://你的设备IP:58090会出现 XiaoMusic 的 Web 界面——注意这个 IP 要填部署设备的局域网地址别用 localhost。做完这一步你会得到一个正在运行的服务以及一个能看见全部功能的后台页面。但这只是空壳接下来才是关键。第 4 步绑定小米账号勾选你的音箱后台设置页是所有魔法的起点动作顺序如下在设置页填入你的小米账号和密码点保存系统自动去小米服务器拉取你名下的设备列表刷新页面找到你的小爱音箱勾选它再次保存然后重启一次容器让设备 ID 生效。这一步如果卡住九成是登录问题最常见的原因和解法现象对策保存后看不到设备列表关掉本地代理再试最有效的一招一直提示登录失败在局域网里用米家或小爱音箱 App 重新登录一次某型号怎么都不出设备到 mi.com 官网登录一次过一下人机验证做完这一步你会得到一台真正认主的小爱音箱——从这一刻起它才算加入了你的私人音乐体系。让小爱听懂你的话口令与自定义关键词绑定成功后下面的口令小爱都能听懂你说它做播放歌曲周杰伦的晴天搜索并播放指定歌曲下一首 / 上一首切换曲目随机播放 / 单曲循环切换播放模式播放歌单夜跑播放对应文件夹里的歌单加入收藏把当前歌曲收进收藏歌单30分钟后关机定时停止播放有个新手常踩的坑默认口令以播放歌曲开头说播放音乐是没用的——除非你自己改。设置页里有一组关键词配置想换就换{ keywords_play: 放点好听的 }把关键词改成自家习惯的说法老人小孩都能用自己的方式点歌。这套口令映射逻辑在 xiaomusic/config.py 里想折腾的可以慢慢研究。歌单、格式与安全感三件小事歌单从哪来三个来源放进音乐目录的文件夹会各自成为一个歌单一层文件夹一个歌单说出歌名后XiaoMusic 会用 yt-dlp 从在线平台下载还支持 JSON 格式的网络歌单也能把 m3u 电台文件转成歌单导入。播放列表的展开效果很顺滑用起来像是给音乐库装了扇能推开的天窗。哪些格式能播mp3、flac、wav、ape、ogg、m4a 基本全覆盖。少数老型号如 L05B、L05C播不了无损在设置里打开转换为 MP3就行代价是稍微吃点 CPU。安全感从哪来三条红线别把服务暴露到公网除非你开启了登录认证别用小爱账号绑定摄像头账号一旦泄露损失会放大公共 WiFi 下不要配置防止账号密码被截走。你可能想问的几个问题Q我的音箱是很老的型号能用吗A主流在售和停产型号基本都在支持列表里从老款 L05B 到 Xiaomi Sound Pro 都有覆盖官方清单见 docs/issues/index.md。老型号播不了 flac 就开转换为 MP3。Q部署好了但语音没反应A语音口令功能默认关闭需要到设置页打开获取对话记录开关首次保存设备后重启一次容器再检查口令前缀是不是播放歌曲。完整排查顺序在 docs/issues/99.md 里有汇总。Q登录失败、看不到设备列表怎么办A按优先级试三招关本地代理 → 米家/小爱 App 重新登录 → 去 mi.com 官网过一遍验证。绝大多数登录问题都能被这三招解决。Q能把我的歌单分享给朋友吗A可以。XiaoMusic 支持 JSON 网络歌单也能把现成的 m3u 电台文件转成 JSON 导入详细用法见 docs/issues/78.md。想先看看源码再动手就克隆下来慢慢读git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic或者干脆跳过读代码这一步直接按上面四小步把服务跑起来让那台在家吃灰的小爱音箱从今晚开始只放你真正想听的歌。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考