十分钟装好用语音点播本地曲库XiaoMusic部署与使用指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic快速了解XiaoMusic 是让小米小爱音箱播放本地曲库和在线音乐的开源服务核心是语音点播、歌单管理和自动下载。在 NAS 或电脑上用 Docker 跑起来后你会得到一个网页管理后台输入小米账号绑定音箱之后说播放歌曲 歌名就能点播本地文件曲库外歌曲会自动搜索下载再播放。从启动到音箱出声只需一条命令前置条件只有一条家里有一台常开的设备NAS、台式机或迷你主机装好 Docker且小爱音箱和它处于同一局域网。docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic几个参数说明一下为什么这么写58090是本机访问端口可随意改8090是容器内部端口固定不动。两个-v分别挂载音乐和配置目录建议和音乐放两个磁盘位置——音乐文件会越下越多配置目录则很小分开方便备份。目录不存在会启动失败先执行mkdir -p /xiaomusic_music /xiaomusic_conf建好。拉不动官方镜像时把镜像名换成docker.hanxi.cc/hanxi/xiaomusic这个国内地址即可。启动成功后浏览器打开http://你的设备IP:58090这是 Web 管理后台。首次访问要输入小米账号和密码并保存设备列表里才会出现你的音箱其余参数都在这页面上改不用再碰环境变量。以上是最省事的 Docker 方式不需要拉取代码如果你想改代码可以把仓库 clone 到本地地址https://gitcode.com/GitHub_Trending/xia/xiaomusic也可以直接pip install -U xiaomusic以命令行方式启动。三个最好用的功能语音口令不碰手机控制播放默认所有指令都带播放歌曲前缀直接说播放音乐是识别不到的。常用口令包括播放歌曲 歌名先搜本地曲库命中即播上一首 / 下一首、单曲循环 / 全部循环 / 随机播放播放歌单 目录名、播放歌单收藏、加入收藏 / 取消收藏。注意设置页里的语音口令获取对话记录开关默认是关的不开它后台收不到你说过的话语音控制自然无效。Web 控制面板标注图列表、搜索、删除、播放模式切换、设备音量条各在什么位置一目了然。本地曲库文件放进去就自动入库把自己的音乐拷进挂载的/xiaomusic_music目录服务会自动扫描入库支持 mp3、flac、wav、ape、ogg、m4a 六种格式在线下载的歌曲以 mp3 存到 download 子目录。曲库里的歌走播放歌曲 歌名一条指令完成搜索加播放不用联网搜源出曲很快。有个格式坑要提前说L05B、L05C 等部分老型号播不了 flac要么在设置里打开转换为MP3费 CPU要么提前用别的工具批量转码。音乐库列表页按歌手分组展示曲库顶部标签可切换到所有歌曲、收藏、下载三个分类。自定义口令把自己的一句话变成功能项目在 config-example.json 里给出了key_word_dict的完整示例给任意一句口令映射到内置命令或插件函数比如测试链接对应一次httpget()请求。对应逻辑写在 plugins/ 目录下的 Python 文件里Docker 环境把该目录挂载出来改完即生效。配合分钟后关机这类现成口令可以让音箱按你的习惯工作。两个典型用法曲库里没有的歌。对音箱说播放歌曲 某首歌本地搜不到时它会用 yt-dlp 自动在线搜索下载完成后直接开播歌同时落到下载列表——下次再点就是秒播。适合家里没囤全曲库、又懒得手动下载的情况。睡前倒计时。说N分钟后关机音箱播完倒计时自动停止不用下床去按。这条口令默认就在指令列表里属于开箱即用。常见问题速查问题对策后台看不到设备列表确认音箱与主机同局域网、关掉代理米家 App 和 mi.com 重新登录账号网页能播但语音无效设置页打开语音口令开关口令别忘播放歌曲前缀flac 格式不播放打开转换为MP3或型号兼容模式或提前转码日志显示播放却没声音检查后台地址hostname音箱能否访问、是否同局域网改过端口要同步改参数更多报错和对应解法都沉淀在 FAQ 问题集合 里安装前翻一遍能省不少事。仓库里的配套资源FAQ 问题集合登录失败、端口、镜像源等常见问题的排查清单文档汇总改端口、网络歌单、定时任务、批量下载等进阶教程入口自定义口令插件说明口令词与插件代码的完整配置教程config-example.json全部配置项示例照着填即可plugins/口令插件的示例代码目录新插件就放在这里。另外说明一句README 里标注项目已停止维护作者建议后续需求迁移到社区接力项目现有功能完整按本文安装使用没有问题。最后一步先跑通那条 docker 命令并绑定小米账号然后对音箱说一句播放歌曲 歌名整条链路就验证完了。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考