小爱音箱播放本地音乐xiaomusic 用 Docker 三步快速部署【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是一个给小爱音箱播放本地音乐和网络歌曲的开源工具它把 NAS 里存放的 MP3、FLAC 直接推给音箱也能在线下载网络歌曲同时保留小爱同学的语音控制。下面用 Docker 三步在 NAS 上完成部署并整理好语音口令、歌单接入和常见故障的处理办法看完就能让自己的小爱音箱自由播放想听的内容。小爱音箱播放本地音乐比官方服务多出来什么普通小爱音箱只能播内置音乐服务的歌想放自己 NAS 里的收藏基本没辙。xiaomusic 的思路是接管音箱的播放入口它作为一个常驻服务运行音箱收到播放指令后实际拉取的是你指定的本地文件或在线下载的文件而不经过官方曲库。换来的好处有三点都可以直接验证。本地音乐直推NAS 或电脑里的 MP3、FLAC、WAV、APE、OGG、M4A 文件放进音乐目录就能被扫出来播放下载的歌曲统一存为 MP3。在线资源接入底层用 yt-dlp 抓取网络歌曲和电台你说歌名它先下载再播。语音口令不丢依然对着小爱同学说人话就能控制口令词还能自己改。上图是 web 控制台的操作面板左侧是设备与歌单入口中间是播放列表和播放/切歌/循环/音量控制右上角可切换当前设备。第一次跑起来后你主要就是在这一页完成账号登录、选设备、点播放。支持哪些音箱型号项目对常见型号都做了适配以下是官方已测试清单型号可在小米 IoT 平台反查产品名型号产品名L06A小爱音箱L07ARedmi 小爱音箱 PlayL16AXiaomi SoundL17AXiaomi Sound ProLX06小爱音箱 ProLX01小爱音箱 miniL05B / L05C小爱音箱 Play / Play 增强版L09A小米音箱 ArtLX04 / X10A / X08A触屏版音箱M01 / XMYX01JY小米小爱音箱 HDOH2 / OH2PXIAOMI 智能音箱 / Pro支持哪些音频格式mp3、flac、wav、ape、ogg、m4a 都能扫到。但要注意L05B、L05C、LX06、L16A 这几款不支持 flac遇到放不出声音的情况去设置页打开转换为 MP3会多占 CPU或型号兼容模式即可详见 FAQ 集合。Docker 三步在 NAS 上部署 xiaomusic部署走容器最省事不需要单独装 Python 环境。整个过程就三步建目录、跑容器、填账号。第一步建好两个挂载目录。一个放音乐music一个放配置conf建议分开mkdir -p /xiaomusic_music /xiaomusic_conf第二步启动容器。任选 Docker Compose 或一条 docker run 命令国内网络慢的话把镜像换成docker.hanxi.cc/hanxi/xiaomusic这个国内源docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic其中58090是你 NAS 上对外开放的端口8090是容器内部端口别改后者。/xiaomusic_music、/xiaomusic_conf是主机上的真实路径可以换成你自己的目录容器里的/app/music、/app/conf是固定的不要动。第三步打开网页填账号。浏览器访问http://你的NAS_IP:58090在设置页填入小米账号和密码带*的项必填保存后会自动拉出设备列表勾选你的音箱即可。现在账号密码、口令词等都能直接在网页改不再需要折腾环境变量。拉不动镜像怎么办如果docker pull卡住或失败多半是镜像源问题。换成国内源docker.hanxi.cc/hanxi/xiaomusic或借助 DaoCloud 中转先拉m.daocloud.io/docker.io/hanxi/xiaomusic:latest再docker tag回hanxi/xiaomusic:latest就能用。各 NAS 换镜像源的步骤见 FAQ 集合。登录失败、看不到设备怎么办后台一直刷不出设备列表日志里报Login Failed按这个顺序试基本能解决关掉本地代理在米家 App 里退出后重新登录去 mi.com 官网重新登录一次人脸或滑块验证能解决绝大多数情况最后核对setting.json里的账号密码。NAS 跑容器时可把 Docker 网络模式从 bridge 改成 host 再试。接入三种音乐来源本地目录、网络歌单、在线下载跑起来之后往里装歌有三种路子可以混着用。上图就是扫出来的音乐列表顶部分全部 / 所有歌曲 / 收藏 / 下载四个标签双击某一行就能在当前设备快速播放。本地目录一层文件夹就是一个歌单把音乐拷进music目录即可扫描时会按上面列的格式逐个识别。目录结构直接决定歌单每一层文件夹会被当成一个播放列表所以周杰伦欧美这样按目录分就能用播放歌单 目录名的口传唤出来。想接多个音乐目录在 Compose 里多加一行 volume 映射到/app/music/子目录就行注意此时不能再单独映射/app/music。网络歌单JSON 配电台和歌单除了本地文件还能配一个 JSON 格式的网络歌单里面既可以放歌曲也可以放电台甚至能直接用别人分享的链接。项目自带一个 m3u 转换工具可以把 m3u 电台文件一键转成它认的 JSON 歌单用法见 官方文档。在线下载说个歌名先下再放这是隐藏也最好用的一个玩法对小爱说播放歌曲 小猪佩奇的故事服务会先调 yt-dlp 把相关内容下下来再交给音箱播。给孩子放故事音频、临时想找一首没存过的歌靠这一句就够了。下载下来的文件会落进download目录之后就走本地播放不用重复下载。FLAC 没声音怎么办日志明明写着正在播放音箱却不出声先点播放旁边的链接按钮看看默认那条链接在浏览器里能不能打开。打不开多半是hostname配错了——它必须是小爱音箱所在的局域网可访问地址Windows 上别填 localhost要填 192 开头的那个 IP并且关一下防火墙。如果端口改过默认 8090记得相关参数要同步改走 https 反代时hostname要带上https://前缀。确实是 flac 不支持的型号就按前面说的开转换为 MP3。小爱音箱语音口令速查与自定义xiaomusic 把播放歌曲这类口令映射到具体动作下面是默认可用的口令照着说就行想做的事可以说的口令放本地歌播放歌曲 / 放歌曲点歌播放歌曲 歌名如播放歌曲 周杰伦 晴天切歌上一首 / 下一首停 / 关停止 / 停止播放 / 暂停 / 关机播放模式单曲循环 / 全部循环 / 随机播放 / 顺序播放放某个歌单播放歌单 目录名 / 播放歌单收藏收藏加入收藏 / 取消收藏在线点歌在线播放 歌名定时关N 分钟后关机注意两点一是口令前缀默认是播放歌曲你直接说播放音乐是不认的二是语音口令功能默认是关着的第一次要在设置页打开获取对话记录 / 语音口令开关保存完 did 后重启一次容器。不用的时候建议随手关掉避免频繁拉取对话记录把账号顶到登录失败。把口令改成自己爱说的不想被播放歌曲这个前缀框住可以直接改映射表。配置文件里key_word_dict和user_key_word_dict就是口令 → 动作的字典加一行点歌: play就能认你的新说法。想更进阶比如口令触发一段自定义脚本或发个 HTTP 请求plugins/ 目录里给了code1、httpget、httppost三个现成示例照着写一个自己的动作函数即可项目还支持 JS 插件能进一步扩展在线播放等能力。完整配置项参考 config-example.json。让小爱音箱音乐服务长期稳定运行安全与故障排查公网访问一定开密码如果你把服务暴露到公网务必打开密码登录并设一个复杂密码别在公共 WiFi 下用后台——否则小米账号密码有泄露风险。还有一点很关键别把小爱音箱绑定的那个小米账号同时挂摄像头账号一旦泄露监控录像也可能跟着暴露。高频故障速查现象先查这里登录失败 / 无设备列表关代理、米家 App 重登、mi.com 官网重登、核对账号密码日志显示播放却没声音点播放链接测默认链接hostname是否为局域网可达地址端口 8090 是否同步型号开型号兼容模式FLAC 放不出L05B/L05C/LX06/L16A 不支持 flac开转换为 MP3网页能播、语音控制无效打开语音口令开关确认口令前缀是播放歌曲首次配 did 后重启容器用段时间后设备消失平时关掉语音口令把 TTS 从小米自带的换成 Edge-TTS 音色镜像拉取失败换国内源 / DaoCloud 中转这些条目都能直接在 FAQ 集合 里找到对应的详细讨论遇到新报错也建议先在那里搜一遍。想动手改代码项目后端是 Python FastAPI前端 jQuery用 Docker 打包。从源码跑起来只需执行依赖安装脚本后pdm run xiaomusic.py默认同样监听 8090 端口接口文档可以直接访问后台的/docs页面查看方便做二次开发或对接自己的设备。迁移提示xiaomusic 因作者精力原因已停止维护不再新增功能、修复 bug 或处理新 issue。后续建议迁移到社区接力项目songloft-org/songloft那里在持续更新并接受共建。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
小爱音箱播放本地音乐xiaomusic 用 Docker 三步快速部署【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是一个给小爱音箱播放本地音乐和网络歌曲的开源工具它把 NAS 里存放的 MP3、FLAC 直接推给音箱也能在线下载网络歌曲同时保留小爱同学的语音控制。下面用 Docker 三步在 NAS 上完成部署并整理好语音口令、歌单接入和常见故障的处理办法看完就能让自己的小爱音箱自由播放想听的内容。小爱音箱播放本地音乐比官方服务多出来什么普通小爱音箱只能播内置音乐服务的歌想放自己 NAS 里的收藏基本没辙。xiaomusic 的思路是接管音箱的播放入口它作为一个常驻服务运行音箱收到播放指令后实际拉取的是你指定的本地文件或在线下载的文件而不经过官方曲库。换来的好处有三点都可以直接验证。本地音乐直推NAS 或电脑里的 MP3、FLAC、WAV、APE、OGG、M4A 文件放进音乐目录就能被扫出来播放下载的歌曲统一存为 MP3。在线资源接入底层用 yt-dlp 抓取网络歌曲和电台你说歌名它先下载再播。语音口令不丢依然对着小爱同学说人话就能控制口令词还能自己改。上图是 web 控制台的操作面板左侧是设备与歌单入口中间是播放列表和播放/切歌/循环/音量控制右上角可切换当前设备。第一次跑起来后你主要就是在这一页完成账号登录、选设备、点播放。支持哪些音箱型号项目对常见型号都做了适配以下是官方已测试清单型号可在小米 IoT 平台反查产品名型号产品名L06A小爱音箱L07ARedmi 小爱音箱 PlayL16AXiaomi SoundL17AXiaomi Sound ProLX06小爱音箱 ProLX01小爱音箱 miniL05B / L05C小爱音箱 Play / Play 增强版L09A小米音箱 ArtLX04 / X10A / X08A触屏版音箱M01 / XMYX01JY小米小爱音箱 HDOH2 / OH2PXIAOMI 智能音箱 / Pro支持哪些音频格式mp3、flac、wav、ape、ogg、m4a 都能扫到。但要注意L05B、L05C、LX06、L16A 这几款不支持 flac遇到放不出声音的情况去设置页打开转换为 MP3会多占 CPU或型号兼容模式即可详见 FAQ 集合。Docker 三步在 NAS 上部署 xiaomusic部署走容器最省事不需要单独装 Python 环境。整个过程就三步建目录、跑容器、填账号。第一步建好两个挂载目录。一个放音乐music一个放配置conf建议分开mkdir -p /xiaomusic_music /xiaomusic_conf第二步启动容器。任选 Docker Compose 或一条 docker run 命令国内网络慢的话把镜像换成docker.hanxi.cc/hanxi/xiaomusic这个国内源docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic其中58090是你 NAS 上对外开放的端口8090是容器内部端口别改后者。/xiaomusic_music、/xiaomusic_conf是主机上的真实路径可以换成你自己的目录容器里的/app/music、/app/conf是固定的不要动。第三步打开网页填账号。浏览器访问http://你的NAS_IP:58090在设置页填入小米账号和密码带*的项必填保存后会自动拉出设备列表勾选你的音箱即可。现在账号密码、口令词等都能直接在网页改不再需要折腾环境变量。拉不动镜像怎么办如果docker pull卡住或失败多半是镜像源问题。换成国内源docker.hanxi.cc/hanxi/xiaomusic或借助 DaoCloud 中转先拉m.daocloud.io/docker.io/hanxi/xiaomusic:latest再docker tag回hanxi/xiaomusic:latest就能用。各 NAS 换镜像源的步骤见 FAQ 集合。登录失败、看不到设备怎么办后台一直刷不出设备列表日志里报Login Failed按这个顺序试基本能解决关掉本地代理在米家 App 里退出后重新登录去 mi.com 官网重新登录一次人脸或滑块验证能解决绝大多数情况最后核对setting.json里的账号密码。NAS 跑容器时可把 Docker 网络模式从 bridge 改成 host 再试。接入三种音乐来源本地目录、网络歌单、在线下载跑起来之后往里装歌有三种路子可以混着用。上图就是扫出来的音乐列表顶部分全部 / 所有歌曲 / 收藏 / 下载四个标签双击某一行就能在当前设备快速播放。本地目录一层文件夹就是一个歌单把音乐拷进music目录即可扫描时会按上面列的格式逐个识别。目录结构直接决定歌单每一层文件夹会被当成一个播放列表所以周杰伦欧美这样按目录分就能用播放歌单 目录名的口传唤出来。想接多个音乐目录在 Compose 里多加一行 volume 映射到/app/music/子目录就行注意此时不能再单独映射/app/music。网络歌单JSON 配电台和歌单除了本地文件还能配一个 JSON 格式的网络歌单里面既可以放歌曲也可以放电台甚至能直接用别人分享的链接。项目自带一个 m3u 转换工具可以把 m3u 电台文件一键转成它认的 JSON 歌单用法见 官方文档。在线下载说个歌名先下再放这是隐藏也最好用的一个玩法对小爱说播放歌曲 小猪佩奇的故事服务会先调 yt-dlp 把相关内容下下来再交给音箱播。给孩子放故事音频、临时想找一首没存过的歌靠这一句就够了。下载下来的文件会落进download目录之后就走本地播放不用重复下载。FLAC 没声音怎么办日志明明写着正在播放音箱却不出声先点播放旁边的链接按钮看看默认那条链接在浏览器里能不能打开。打不开多半是hostname配错了——它必须是小爱音箱所在的局域网可访问地址Windows 上别填 localhost要填 192 开头的那个 IP并且关一下防火墙。如果端口改过默认 8090记得相关参数要同步改走 https 反代时hostname要带上https://前缀。确实是 flac 不支持的型号就按前面说的开转换为 MP3。小爱音箱语音口令速查与自定义xiaomusic 把播放歌曲这类口令映射到具体动作下面是默认可用的口令照着说就行想做的事可以说的口令放本地歌播放歌曲 / 放歌曲点歌播放歌曲 歌名如播放歌曲 周杰伦 晴天切歌上一首 / 下一首停 / 关停止 / 停止播放 / 暂停 / 关机播放模式单曲循环 / 全部循环 / 随机播放 / 顺序播放放某个歌单播放歌单 目录名 / 播放歌单收藏收藏加入收藏 / 取消收藏在线点歌在线播放 歌名定时关N 分钟后关机注意两点一是口令前缀默认是播放歌曲你直接说播放音乐是不认的二是语音口令功能默认是关着的第一次要在设置页打开获取对话记录 / 语音口令开关保存完 did 后重启一次容器。不用的时候建议随手关掉避免频繁拉取对话记录把账号顶到登录失败。把口令改成自己爱说的不想被播放歌曲这个前缀框住可以直接改映射表。配置文件里key_word_dict和user_key_word_dict就是口令 → 动作的字典加一行点歌: play就能认你的新说法。想更进阶比如口令触发一段自定义脚本或发个 HTTP 请求plugins/ 目录里给了code1、httpget、httppost三个现成示例照着写一个自己的动作函数即可项目还支持 JS 插件能进一步扩展在线播放等能力。完整配置项参考 config-example.json。让小爱音箱音乐服务长期稳定运行安全与故障排查公网访问一定开密码如果你把服务暴露到公网务必打开密码登录并设一个复杂密码别在公共 WiFi 下用后台——否则小米账号密码有泄露风险。还有一点很关键别把小爱音箱绑定的那个小米账号同时挂摄像头账号一旦泄露监控录像也可能跟着暴露。高频故障速查现象先查这里登录失败 / 无设备列表关代理、米家 App 重登、mi.com 官网重登、核对账号密码日志显示播放却没声音点播放链接测默认链接hostname是否为局域网可达地址端口 8090 是否同步型号开型号兼容模式FLAC 放不出L05B/L05C/LX06/L16A 不支持 flac开转换为 MP3网页能播、语音控制无效打开语音口令开关确认口令前缀是播放歌曲首次配 did 后重启容器用段时间后设备消失平时关掉语音口令把 TTS 从小米自带的换成 Edge-TTS 音色镜像拉取失败换国内源 / DaoCloud 中转这些条目都能直接在 FAQ 集合 里找到对应的详细讨论遇到新报错也建议先在那里搜一遍。想动手改代码项目后端是 Python FastAPI前端 jQuery用 Docker 打包。从源码跑起来只需执行依赖安装脚本后pdm run xiaomusic.py默认同样监听 8090 端口接口文档可以直接访问后台的/docs页面查看方便做二次开发或对接自己的设备。迁移提示xiaomusic 因作者精力原因已停止维护不再新增功能、修复 bug 或处理新 issue。后续建议迁移到社区接力项目songloft-org/songloft那里在持续更新并接受共建。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
