xiaomusic Docker部署完整指南小爱音箱用语音播放本地音乐【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic早上六点四十分你说了一句播放专辑小爱音箱就开始播放 NAS 里存的音乐——没有会员费。xiaomusic 是一个让小爱音箱用语音播放本地音乐的开源工具本文完整走一遍 xiaomusic Docker部署 与配置。xiaomusic 是什么适合谁xiaomusic 运行在 NAS 或家用服务器上它用网页控制台管理本地音乐库通过小米账号接入小爱音箱音箱收到一句语音指令就能播放本地歌曲本地找不到时还可以在线搜索并下载播放。适合已经有小爱音箱、且 NAS 或电脑上存着本地音乐库的人适合想自定义语音口令的人比如把下一首改成自己习惯的说法适合有多台小爱音箱、想让一个服务统一接管的人没有小米账号、无法完成设备绑定的不必折腾只打算听在线音乐、没有管理本地库需求的也不必折腾。xiaomusic Docker部署一个配置文件加一条命令这一节负责把服务跑起来。宿主机装好 Docker 即可再准备两个本机目录一个放音乐、一个放配置不存在就先建好。compose 文件里只有一个服务services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf冒号左边的两个目录改成你实际使用的路径右边是容器内的固定目录不要动。左侧 58090 是本地访问网页控制台的端口右侧 8090 是容器固定端口不可修改。文件保存后执行docker compose up -d即可restart: always保证宿主机重启后服务自动拉起。账号、设备等参数都不需要设置环境变量后面在网页里填。xiaomusic配置从绑定设备到第一次语音点播这一节把控制台、设备、音乐库和语音指令串起来。服务启动后浏览器打开http://服务器IP:58090。进入左侧的设备控制入口填入小米账号和密码并保存页面会自动扫描局域网内可用的音箱选中你的设备后绑定完成系统会同时记下它的 DID设备标识。下图标出了控制台上各区域的主要操作如果自动发现不到设备打开小爱音箱 App 的设备详情页找到 DID在设置里手动填入。然后放音乐把文件拷进映射的音乐目录支持 mp3、flac、wav、ape、ogg、m4a、wma子目录会作为歌单处理在设置里打开文件监控后新增文件会自动入库不用手动刷新。最后试语音。高频的四条开箱即用播放歌曲周杰伦、下一首、单曲循环、10分钟后关机。如果说了一首本地没有的歌xiaomusic 会在线搜索、下载到音乐目录再播放。进阶玩法多设备、网络歌单、定时播放多台音箱同管在配置项mi_did里用逗号分隔多个 DID一个服务就能控制多台小爱音箱控制台右上角的下拉框可以切换当前操作的目标设备。网络歌单music_list_url指向一个在线 JSON 歌单或custom_play_list_json指向本地文件歌单内容变了库就跟着变不用动音乐目录。定时播放crontab_json指向一个定时文件比如每天早上八点播一段晨间音乐、睡前定点停止播放音箱到点自己跑。账号与端口安全服务只在局域网用就保持默认需要对外暴露时打开设置里的网页登录认证并设强密码同时把 58090 端口限制在白名单内。绑定的小米账号建议用独立小号不要把摄像头这类敏感设备挂在该账号下。避坑清单xiaomusic配置的常见问题网页控制台打不开→ 58090 端口被占用或映射写错 → 换一个本地端口映射容器端 8090 保持不变。设备列表里没有音箱→ 账号未保存或设备不在同一网络 → 重新保存小米账号确认音箱与服务器在同一局域网或直接手动填 DID。播放后无声或卡顿→ 设备型号不支持当前音频格式 → 在设置页打开转换为 MP3。新增歌曲后歌单不更新→ 没开文件监控 → 打开监控开关并给扫描留一点防抖时间。语音指令没反应→ 口令与配置里的词条不匹配 → 在配置文件中核对key_word_dict的准确说法也可以自行登记新口令。xiaomusic 的价值在于把音乐库重新交回自己手里文件是自己的歌单是自己的播放入口只是一句语音。完整配置项见仓库 README 与config-example.json。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考