小爱音箱秒变私人点歌台XiaoMusic 一句话语音点播完整部署指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你有没有过这种时刻辛辛苦苦整理了一整盘无损音乐想在客厅用音箱好好享受却发现小爱同学只会播放曲库里那些会员专属的歌曲想听的歌没有、音质被压缩、切歌还得在手机 App 里翻半天如果有一句话就能让音箱直接播放你自己收藏的音乐库呢XiaoMusic 正是为此而生——它是一款开源工具让你通过语音口令指挥小爱音箱播放本地和在线音乐想听的歌找不到时还能用 yt-dlp 自动帮你下载。今天这份指南就带你从零开始把它跑起来。先看看成果你的音箱会变成什么样部署完成后你的小爱音箱会从一个只会读会员曲库的播放器升级成私人点歌台。只需动嘴就能做到点歌说播放歌曲周杰伦晴天自动检索并播放切歌说下一首上一首说停止播放即刻安静模式支持单曲循环全部循环随机播放顺序播放歌单说播放歌单流行音乐按文件夹歌单整单播放收藏说加入收藏当前歌曲进入你的收藏歌单更妙的是这些口令全部可以自定义你甚至能教会音箱执行自定义任务。所有操作都在网页后台完成手机、电脑浏览器都能访问。部署后的网页控制台设备切换、播放列表、音量调节、全屏歌词一目了然动手前先排雷这些条件提前备好好消息是 XiaoMusic 的部署门槛很低但下面几点如果不提前确认很容易卡在半路。花两分钟对一遍能省下你一下午。你需要的东西用途注意事项一台小爱音箱语音播放终端主流型号均已支持具体型号表见下文一个小米账号连接音箱的钥匙必须是该音箱绑定的账号一台能跑 Docker 的设备承载服务NAS、迷你主机、旧电脑都行一个音乐文件目录存放你的歌支持 mp3 / flac / wav / ape / ogg / m4a三个高频易错点请先记住端口别搞混浏览器访问用的是你映射出去的主机端口如58090容器内固定8090不要动。两个挂载目录要分开音乐目录和配置目录各自独立别混在一个文件夹里。登录失败先查代理如果绑定账号时提示 Login Failed绝大多数情况是设备开了加速代理关掉代理再试。核心实操Docker 一键部署的最小可行路径第一步创建目录各司其职在运行 Docker 的机器上建好两个目录一个放歌、一个放配置mkdir -p /xiaomusic_music mkdir -p /xiaomusic_conf音乐目录将来可以塞进各种子文件夹比如按歌手、按专辑分类XiaoMusic 会自动把子目录识别成歌单。第二步编写 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 # 配置文件目录同样挂载到容器内为什么这么写容器里的/app/music和/app/conf是写死的固定路径不要修改你只需要把冒号左边的目录换成自己机器上的实际路径。58090可以改成你喜欢的端口8090保持原样。第三步一键启动保存文件后在docker-compose.yml所在目录执行docker-compose up -d等镜像下载完、容器启动好在浏览器输入http://你的设备IP:58090就能看到网页后台了。想确认运行状态可以执行docker ps | grep xiaomusic查看容器是否在运行。第四步绑定小米账号这一步最关键打开网页后台进入设置页面这里要做三件事填入小米账号和密码保存。带*号的都是必填项其他参数暂时不用动保存后系统会自动拉取你的设备列表刷新页面勾选要控制的那台小爱音箱再次保存完成这步音箱和 XiaoMusic 之间的桥梁就算打通了。第五步打开语音口令开关最后一步容易被忽略语音口令功能默认是关闭的。去设置页面打开【获取对话记录】也叫【语音口令】开关你的点歌之旅才算真正解锁。建议不用的时候随手关掉它因为频繁请求可能导致账号登录受限。效果验证与进阶玩法验收成果再玩点花的先说一句话验证成功对着音箱说出默认口令前缀开头的指令播放歌曲周杰伦晴天。如果它开始播放你本地库里的歌恭喜整套系统已经跑通了再试试下一首停止播放加入收藏感受一下动嘴不动手的快乐。后台的歌曲列表界面支持按全部、收藏、下载等标签分类浏览进阶玩法一让小爱现搜现下没有的歌也能播这是最惊艳的隐藏功能。对小爱说一句播放歌曲小猪佩奇的故事XiaoMusic 会先用 yt-dlp 把内容下载下来然后直接开始播放也就是说曲库里没有的资源你也能靠一句话变出来。想听什么新鲜内容试试这个口令效果立竿见影。进阶玩法二自定义语音口令与插件默认口令不够顺手你可以完全自定义。在config-example.json里口令和指令的对应关系一目了然{ 播放歌曲: play, 播放本地歌曲: playlocal, 关机: stop, 下一首: play_next, 随机播放: set_play_type_rnd, 分钟后关机: stop_after_minute }把播放歌曲改成来首歌也完全可以。更进一步XiaoMusic 支持插件扩展你可以给音箱教自定义口令让它去执行任意代码逻辑。这部分配置方式可以参考项目中的config-example.json与插件文档docs/issues/105.md。进阶玩法三定时任务与网络歌单想每天早上被音乐叫醒用xiaomusic/crontab.py配置定时播放即可比如设定早上 7 点播放你的专属歌单。另外项目支持 JSON 格式的网络歌单还能把 m3u 电台文件一键转换成歌单格式接入别人分享的电台资源玩法参考docs/issues/78.md。播放列表的动态折叠效果歌单再多也不乱常见问题速查FAQ问题一绑定账号时提示 Login Failed 登陆失败原因多数是加速代理干扰或账号安全验证未通过。 解法先关闭设备上的代理再重试也可以去小米官网登录一次账号完成人脸或滑块验证基本能解决 99% 的登录问题。更完整的排查步骤见 FAQ 文档docs/issues/99.md。问题二网页后台能播放语音控制却无效原因语音口令开关没打开或口令前缀不匹配。 解法确认已在设置里打开【获取对话记录】开关保存设备后记得重启一次容器说话时必须以播放歌曲这类口令前缀开头播放音乐这类词是无效的。问题三日志显示正在播放但音箱没声音原因通常是地址或端口配置问题音箱访问不到服务。 解法检查 hostname 是否填成了 Docker 主机地址且与音箱同处一个局域网如果是触屏版设备可尝试开启【型号兼容模式】。问题四无法播放 flac 无损格式原因部分老型号音箱如 L05B、L05C不支持 flac。 解法可在设置里打开【转换为MP3】选项但会比较消耗 CPU更稳妥的办法是提前把文件批量转为 mp3 再放入音乐库。问题五Docker 镜像拉取失败原因网络原因导致镜像源不可达。 解法更换镜像源或使用代理不同 NAS 环境更换方式不同网上搜索自己设备的镜像源配置方法即可。总结与行动清单从今天起你的小爱音箱不再是会员曲库播放器而是一个真正懂你收藏的私人点歌台。回顾一下这套方案的核心价值纯语音控制点歌、切歌、调模式全程解放双手Docker 一键部署两条命令搞定NAS 玩家友好格式全面无损、常见格式通吃还支持自动下载扩展性强口令自定义、插件、定时任务、网络歌单现在就可以动手的清单建好音乐与配置两个目录写好docker-compose.yml并启动容器在网页后台绑定小米账号与音箱打开【语音口令】开关对小爱说一句播放歌曲开头的指令验收成果想自己折腾克隆源码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic慢慢研究音乐是生活的调味剂而好的工具让享受变得毫无负担。别让收藏夹里的好歌继续吃灰了现在就动手让你的小爱音箱开口就唱句句都对味。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考