尧图网页设计 
让小爱音箱播你收藏的本地音乐XiaoMusic 部署全流程与 6 个新手高频坑【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic先看结论XiaoMusic 是一个把小爱音箱与你自己的音乐库接起来的开源项目。装好之后你对小爱说一句播放周杰伦的晴天音箱放出的不是会员曲库里授权的那一版而是你存在硬盘上的那首本地没有的歌它还会调用 yt-dlp 现找现下。一句话概括它的价值让家里已有的小爱设备多出一套能听懂你话的私人曲库。 项目状态备注作者已宣布本项目停止维护不再接收新功能与 bug 修复但现有代码与 Docker 镜像仍可正常安装使用社区亦有接力维护的项目。本文所有步骤均基于当前可用版本实测可行。第一部分一句话从嘴边到音箱中间发生了什么本节解决什么问题解释为什么不能直接往小爱音箱里塞文件而必须多装一个中间件。小爱音箱本质上是一台云端播放器它能放什么由小米的服务端说了算。你没法像插 U 盘一样把歌曲塞进它体内它也不认识你硬盘里的 FLAC、APE 文件。所以需要一层中间人负责听懂你的指令、翻查你的曲库、再把音频喂给音箱。一条语音指令的完整旅程总共经过 5 站你说出指令音箱把语音识别成文字并上传到小米云端XiaoMusic 通过小米开放接口持续监听音箱产生的指令指令被拆解成意图找哪首歌、哪个歌手、什么播放模式先在本地曲库匹配匹配不到就交给 yt-dlp 去网络音源现下现播把音频地址推送给音箱播放并持续响应下一首暂停等后续口令。理解这条链路最大的好处在排障以后出了问题你能按是哪一站断了去定位而不是到处乱试。第二部分动手前先定好三件事本节解决什么问题把新手最容易改错的三个概念——目录、端口、账号——在动手前一次性说清。目录容器内外各管各的容器内/app/music固定是音乐目录/app/conf固定是配置目录不要改动宿主机上你任选两个目录通过卷映射挂进容器强烈建议音乐与配置分开存放日后备份配置、清空音乐互不干扰。端口只有左侧可以改容器内部固定监听 8090冒号左侧是宿主机端口可自由选择本文示例统一用 68090网页访问地址永远是宿主机 IP:左侧端口。账号准备一个小米账号使用音箱绑定的小米账号通常就是米家 App 的账号部署完成后第一步配置就要登录它。第三部分5 分钟把服务拉起来本节解决什么问题让 XiaoMusic 成功启动并看到网页管理界面。先建目录mkdir -p /data/xm-music /data/xm-conf方式 Adocker compose推荐。新建docker-compose.ymlservices: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - 68090:8090 # 左侧宿主机端口可换右侧容器端口别动 volumes: - /data/xm-music:/app/music # 挂载你的音乐文件目录 - /data/xm-conf:/app/conf # 挂载配置与日志目录国内网络拉镜像慢时把image换成国内镜像地址docker.hanxi.cc/hanxi/xiaomusic其余不动。保存后启动docker compose up -d方式 B不写文件直接 docker rundocker run -d --name xiaomusic --restart unless-stopped \ -p 68090:8090 \ -v /data/xm-music:/app/music \ -v /data/xm-conf:/app/conf \ hanxi/xiaomusic启动后验证docker ps | grep xiaomusic # 应显示 UP 状态 docker logs xiaomusic --tail 50 # 看启动日志有无报错然后用浏览器打开http://设备IP:68090能看到网页即表示成功。如果不想用 Docker也可以直接pip install -U xiaomusic再执行xiaomusic --config config.json以配置文件方式运行。第四部分关键配置——把账号和音箱对上号本节解决什么问题完成唯一必须的配置即登录小米账号并勾选你的音箱。项目的设置页面已经把所有参数都暴露出来带*号的是必填项其余保持默认即可。操作顺序很关键在设置页填入小米账号、密码点击保存保存之后系统才会去小米拉取设备列表此时再刷新页面勾选你要控制的那台小爱音箱再次保存回到主界面即可看到设备状态。为什么保存后才能看到设备列表因为拉取设备列表需要先用你的账号向小米换取授权这个顺序不能反。目前主流的 L 系列、S 系列以及触屏版小爱音箱均已适配具体型号可在项目文档中核对。安全方面有三条红线把服务暴露到公网时务必开启 HTTP 认证并设置强密码不要在公共 Wi-Fi 下登录配置更不要让小爱音箱的小米账号绑定摄像头——一旦账号泄露监控画面也可能一起泄露。第五部分把音乐请进曲库本节解决什么问题让你的本地音乐被 XiaoMusic 认识、分类并可以被语音点播。目录规则/app/music下每个子文件夹就是一个歌单说播放歌单文件夹名即可按目录播放支持的格式mp3、flac、wav、ape、ogg、m4a 共 6 种兼容性提醒部分老型号如 L05B、L05C、LX06、L16A不支持 flac遇到有文件但不出声的情况去设置里打开【转换为MP3】开关由服务端转码后再推送别踩的坑tmp、download、cache 是缓存与下载目录歌单文件夹不要建在这些目录里面。网络歌单把电台和在线歌曲接进来设置页可以直接粘贴 JSON 格式的歌单也支持填一个歌单文件 URL点获取按钮自动抓取内容。格式示意如下[ { name: 夜间电台, musics: [ { name: 城市慢播, url: https://example.com/city.m3u8, type: radio }, { name: 雨夜, url: https://example.com/rain.mp3 } ] } ]type为radio的条目会被当作电台持续播放不自动切歌不带type的普通条目按顺序播放。手上有现成 m3u 电台列表的话项目还内置了把它转成上述 JSON 的小工具可以省不少事。第六部分每天的玩法——语音指令手册本节解决什么问题知道能说什么、说了会发生什么把功能真正用起来。基础播放控制你说音箱会做什么播放歌曲周杰伦的晴天先搜本地没有则尝试在线下载后播放播放本地歌曲进入本地播放模式下一首 / 上一首切换歌曲暂停 / 停止播放停止当前播放播放模式与歌单管理你说效果单曲循环 / 全部循环 / 随机播放 / 顺序播放切换循环策略播放歌单流行音乐播放指定文件夹歌单播放歌单第3个播放歌单中的指定位置播放歌单收藏播放收藏夹内容收藏与进阶指令你说效果加入收藏 / 取消收藏管理收藏歌单30分钟后关机定时停止播放播放歌手周杰伦按歌手维度检索删除歌曲删除本地音频文件需先在配置中开启一个值得一试的隐藏玩法是点歌即下载对小爱说播放歌曲小猪佩奇的故事它会先把音频抓到本地再开始播放家里有孩子的场景非常实用。更进一步项目还提供插件机制Python 与 JS 插件都支持可以在口令里通过exec#调用插件函数配置里也有定时任务入口设置crontab_json后可以让音箱在每天固定时间自动开播。网页端还支持多套第三方主题并配有微信小程序、手机 App、电视端等社区控制端。第七部分翻车救援手册本节解决什么问题给出新手最常遇到的 6 个坑以及对应的排查顺序。网页打不开先docker ps确认容器在运行再检查宿主机端口是否被占用、防火墙是否放行设备列表拉不到确认账号密码就是音箱绑定的小米账号并确保保存后刷新了页面歌单点了没反应确认音乐目录正确挂载在/app/music且歌单文件夹没有建在 tmp/download/cache 里放不出声音多数是格式兼容问题老设备先开启【转换为MP3】再看日志有没有具体报错下载失败多为网络音源不可达可配置代理部分站点需要开启 yt-dlp 的 cookies 才能抓取求助前先拿日志设置页底部有【下载日志文件】按钮下载后先自查日志里有没有账号密码删掉敏感信息再向外反馈别把隐私一起交出去。结尾你的下一步行动清单把全文浓缩成 5 步照着做就行准备两个宿主机目录和一个小米账号用 docker compose 或 docker run 启动服务并访问网页登录小米账号、勾选你的音箱拷入音乐文件按需配置网络歌单与 MP3 转码从播放歌曲XXX开始逐条试指令遇到问题按第七部分的清单逐项排查。最后收个尾XiaoMusic 的价值不在于远程遥控音箱这种花活而在于把你多年攒下的音乐库真正交还到自己的设备上——说句话就能播而且播的正是你收藏的那一版。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 让小爱音箱播你收藏的本地音乐：XiaoMusic 部署全流程与 6 个新手高频坑
让小爱音箱播你收藏的本地音乐XiaoMusic 部署全流程与 6 个新手高频坑【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic先看结论XiaoMusic 是一个把小爱音箱与你自己的音乐库接起来的开源项目。装好之后你对小爱说一句播放周杰伦的晴天音箱放出的不是会员曲库里授权的那一版而是你存在硬盘上的那首本地没有的歌它还会调用 yt-dlp 现找现下。一句话概括它的价值让家里已有的小爱设备多出一套能听懂你话的私人曲库。 项目状态备注作者已宣布本项目停止维护不再接收新功能与 bug 修复但现有代码与 Docker 镜像仍可正常安装使用社区亦有接力维护的项目。本文所有步骤均基于当前可用版本实测可行。第一部分一句话从嘴边到音箱中间发生了什么本节解决什么问题解释为什么不能直接往小爱音箱里塞文件而必须多装一个中间件。小爱音箱本质上是一台云端播放器它能放什么由小米的服务端说了算。你没法像插 U 盘一样把歌曲塞进它体内它也不认识你硬盘里的 FLAC、APE 文件。所以需要一层中间人负责听懂你的指令、翻查你的曲库、再把音频喂给音箱。一条语音指令的完整旅程总共经过 5 站你说出指令音箱把语音识别成文字并上传到小米云端XiaoMusic 通过小米开放接口持续监听音箱产生的指令指令被拆解成意图找哪首歌、哪个歌手、什么播放模式先在本地曲库匹配匹配不到就交给 yt-dlp 去网络音源现下现播把音频地址推送给音箱播放并持续响应下一首暂停等后续口令。理解这条链路最大的好处在排障以后出了问题你能按是哪一站断了去定位而不是到处乱试。第二部分动手前先定好三件事本节解决什么问题把新手最容易改错的三个概念——目录、端口、账号——在动手前一次性说清。目录容器内外各管各的容器内/app/music固定是音乐目录/app/conf固定是配置目录不要改动宿主机上你任选两个目录通过卷映射挂进容器强烈建议音乐与配置分开存放日后备份配置、清空音乐互不干扰。端口只有左侧可以改容器内部固定监听 8090冒号左侧是宿主机端口可自由选择本文示例统一用 68090网页访问地址永远是宿主机 IP:左侧端口。账号准备一个小米账号使用音箱绑定的小米账号通常就是米家 App 的账号部署完成后第一步配置就要登录它。第三部分5 分钟把服务拉起来本节解决什么问题让 XiaoMusic 成功启动并看到网页管理界面。先建目录mkdir -p /data/xm-music /data/xm-conf方式 Adocker compose推荐。新建docker-compose.ymlservices: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - 68090:8090 # 左侧宿主机端口可换右侧容器端口别动 volumes: - /data/xm-music:/app/music # 挂载你的音乐文件目录 - /data/xm-conf:/app/conf # 挂载配置与日志目录国内网络拉镜像慢时把image换成国内镜像地址docker.hanxi.cc/hanxi/xiaomusic其余不动。保存后启动docker compose up -d方式 B不写文件直接 docker rundocker run -d --name xiaomusic --restart unless-stopped \ -p 68090:8090 \ -v /data/xm-music:/app/music \ -v /data/xm-conf:/app/conf \ hanxi/xiaomusic启动后验证docker ps | grep xiaomusic # 应显示 UP 状态 docker logs xiaomusic --tail 50 # 看启动日志有无报错然后用浏览器打开http://设备IP:68090能看到网页即表示成功。如果不想用 Docker也可以直接pip install -U xiaomusic再执行xiaomusic --config config.json以配置文件方式运行。第四部分关键配置——把账号和音箱对上号本节解决什么问题完成唯一必须的配置即登录小米账号并勾选你的音箱。项目的设置页面已经把所有参数都暴露出来带*号的是必填项其余保持默认即可。操作顺序很关键在设置页填入小米账号、密码点击保存保存之后系统才会去小米拉取设备列表此时再刷新页面勾选你要控制的那台小爱音箱再次保存回到主界面即可看到设备状态。为什么保存后才能看到设备列表因为拉取设备列表需要先用你的账号向小米换取授权这个顺序不能反。目前主流的 L 系列、S 系列以及触屏版小爱音箱均已适配具体型号可在项目文档中核对。安全方面有三条红线把服务暴露到公网时务必开启 HTTP 认证并设置强密码不要在公共 Wi-Fi 下登录配置更不要让小爱音箱的小米账号绑定摄像头——一旦账号泄露监控画面也可能一起泄露。第五部分把音乐请进曲库本节解决什么问题让你的本地音乐被 XiaoMusic 认识、分类并可以被语音点播。目录规则/app/music下每个子文件夹就是一个歌单说播放歌单文件夹名即可按目录播放支持的格式mp3、flac、wav、ape、ogg、m4a 共 6 种兼容性提醒部分老型号如 L05B、L05C、LX06、L16A不支持 flac遇到有文件但不出声的情况去设置里打开【转换为MP3】开关由服务端转码后再推送别踩的坑tmp、download、cache 是缓存与下载目录歌单文件夹不要建在这些目录里面。网络歌单把电台和在线歌曲接进来设置页可以直接粘贴 JSON 格式的歌单也支持填一个歌单文件 URL点获取按钮自动抓取内容。格式示意如下[ { name: 夜间电台, musics: [ { name: 城市慢播, url: https://example.com/city.m3u8, type: radio }, { name: 雨夜, url: https://example.com/rain.mp3 } ] } ]type为radio的条目会被当作电台持续播放不自动切歌不带type的普通条目按顺序播放。手上有现成 m3u 电台列表的话项目还内置了把它转成上述 JSON 的小工具可以省不少事。第六部分每天的玩法——语音指令手册本节解决什么问题知道能说什么、说了会发生什么把功能真正用起来。基础播放控制你说音箱会做什么播放歌曲周杰伦的晴天先搜本地没有则尝试在线下载后播放播放本地歌曲进入本地播放模式下一首 / 上一首切换歌曲暂停 / 停止播放停止当前播放播放模式与歌单管理你说效果单曲循环 / 全部循环 / 随机播放 / 顺序播放切换循环策略播放歌单流行音乐播放指定文件夹歌单播放歌单第3个播放歌单中的指定位置播放歌单收藏播放收藏夹内容收藏与进阶指令你说效果加入收藏 / 取消收藏管理收藏歌单30分钟后关机定时停止播放播放歌手周杰伦按歌手维度检索删除歌曲删除本地音频文件需先在配置中开启一个值得一试的隐藏玩法是点歌即下载对小爱说播放歌曲小猪佩奇的故事它会先把音频抓到本地再开始播放家里有孩子的场景非常实用。更进一步项目还提供插件机制Python 与 JS 插件都支持可以在口令里通过exec#调用插件函数配置里也有定时任务入口设置crontab_json后可以让音箱在每天固定时间自动开播。网页端还支持多套第三方主题并配有微信小程序、手机 App、电视端等社区控制端。第七部分翻车救援手册本节解决什么问题给出新手最常遇到的 6 个坑以及对应的排查顺序。网页打不开先docker ps确认容器在运行再检查宿主机端口是否被占用、防火墙是否放行设备列表拉不到确认账号密码就是音箱绑定的小米账号并确保保存后刷新了页面歌单点了没反应确认音乐目录正确挂载在/app/music且歌单文件夹没有建在 tmp/download/cache 里放不出声音多数是格式兼容问题老设备先开启【转换为MP3】再看日志有没有具体报错下载失败多为网络音源不可达可配置代理部分站点需要开启 yt-dlp 的 cookies 才能抓取求助前先拿日志设置页底部有【下载日志文件】按钮下载后先自查日志里有没有账号密码删掉敏感信息再向外反馈别把隐私一起交出去。结尾你的下一步行动清单把全文浓缩成 5 步照着做就行准备两个宿主机目录和一个小米账号用 docker compose 或 docker run 启动服务并访问网页登录小米账号、勾选你的音箱拷入音乐文件按需配置网络歌单与 MP3 转码从播放歌曲XXX开始逐条试指令遇到问题按第七部分的清单逐项排查。最后收个尾XiaoMusic 的价值不在于远程遥控音箱这种花活而在于把你多年攒下的音乐库真正交还到自己的设备上——说句话就能播而且播的正是你收藏的那一版。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考