小爱音箱免费听全网音乐完整指南XiaoMusic 部署与用法【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic上周日早晨我对客厅的音箱说小爱同学播放周杰伦的《七里香》回应是需要开通会员。不想再为会员付费我当晚在 NAS 上部署了 XiaoMusic第二天点歌直接下载播放。这篇讲清它是什么、怎么装、怎么把常用功能调到位。小爱音箱免费播放方案XiaoMusic 是什么XiaoMusic 是一个开源项目通过绑定小米账号让小爱音箱播放音乐它拦截你的语音播放请求用 yt-dlp 把歌曲下载到 NAS再由音箱本地播放。适合家里有 NAS 或小主机、不想开通音乐会员、又想保留语音点歌体验的用户。工作原理语音口令、按需下载与本地播放口令拦截识别你要听什么绑定小米账号后XiaoMusic 轮询对话记录需在设置页打开【获取对话记录】开关从你的语音指令中提取歌名或歌手再判断本地曲库有没有。按需下载本地没有才联网本地曲库命中就直接播没有时调用 yt-dlp 从在线源拉取音频默认存为 mp3也可保留 flac 等原格式文件统一落到挂载的 music 目录。本地播放不用订阅曲库可复用下载后的文件留在本地音箱走本地播放不依赖在线曲库的会员校验。听过的歌、收藏的歌单都沉淀成自己的音乐库。Docker 部署 XiaoMusic一条命令到能点歌方式一Docker推荐NAS 用户首选docker run -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic参数逐行说明-p 58090:809058090 是宿主机端口可自改8090 是容器固定端口不要动-v /xiaomusic_music:/app/music宿主机上存放下载歌曲的目录改成你已有的音乐目录即可-v /xiaomusic_conf:/app/conf配置文件目录建议与音乐目录分开hanxi/xiaomusic官方镜像国内拉取慢可换docker.hanxi.cc/hanxi/xiaomusic启动后浏览器访问http://NAS_IP:58090在页面输入小米账号密码并保存设备列表就会出现。国内用户拉镜像慢时把镜像名换成docker.hanxi.cc/hanxi/xiaomusic。方式二源码运行适合想改配置或二次开发的git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install pdm run xiaomusic.py首次启动后所有参数都在 Web 设置页维护带*的账号、密码必填其余按需修改。常改的几项music_path曲库目录、convert_to_mp3格式不兼容时开启、search_prefix在线搜索源前缀默认bilisearch:、disable_httpauth公网访问时关掉它并设置账号密码。实际体验数据与设备支持一览指标数据已测试型号18 组含 L05B、L06A、L09A、L16A、L17A、LX01、LX05、LX06 等本地音频格式6 种mp3 / flac / wav / ape / ogg / m4a内置语音口令28 个上一首/下一首、单曲循环、随机播放、收藏、播放歌单等可自定义扩充下载默认格式mp3可保留 flac 等原格式管理入口Web 页面容器默认端口 8090Issue 区有用户反馈配好之后孩子点歌听故事系统会自动先下载再播放不用再折腾平台会员。进阶玩法自定义口令、网络歌单与多设备自定义语音口令在user_key_word_dict里加口令→动作映射仓库示例是测试自定义口令: exec#code1(\hello\)命中口令即执行对应插件代码。把播放晨间音乐这类短语配成一键动作说出口令就触发。网络歌单把music_list_url指向一个 JSON 歌单支持电台和歌曲也可直接用别人分享的链接Web 端还带 m3u 转换工具能把电台的 m3u 文件转成 JSON 格式。配好后一句播放歌单名称就能在音箱上放电台。多设备管理devices配置项为每台设备单独保存设置Web 页右上角可切换目标设备。一台 NAS 上的曲库同时服务客厅、卧室多台音箱切哪台播哪台。避坑指南新手最常问的 5 个问题Q后台看不到我的音箱基本是登录失败。先核对账号密码再关掉本地加速代理去 mi.com 官网重新做一次人脸或滑块验证官方 FAQ 说这能解决 99% 的此类问题。Q网页能播语音口令没反应语音口令功能默认关闭要到设置页打开【获取对话记录】开关。不用的时候随手关掉请求太频繁反而可能把登录挤掉。Q某些 flac 歌曲播不了L05B、L05C、LX06、L16A 这几个型号已知不支持 flac。在设置里打开【转换为MP3】和【型号兼容模式】即可。Q用一段时间设备列表不见了多是获取对话记录太频繁导致。不用语音点歌时把开关关掉问题一般就消失。Q想暴露到公网安全吗务必开启密码登录并设复杂密码对应disable_httpauth配置别在公共 WiFi 下使用绑定了摄像头的小米账号不建议拿来登录本项目。遇到其他报错先在 Web 设置页底部点【下载日志文件】确认日志里没有账号密码再发出来。常见问题大多已有现成答案参见 FAQ 问题集合更多功能说明见 文档汇总。XiaoMusic 把小爱音箱从会员验证器变回点歌工具Docker 一条命令就能跑起来。项目目前由作者停止主动维护但社区仍在接力仓库 README 末尾附有 QQ 频道、QQ 群和微信群入口遇到坑先去那里搜一搜。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考