XiaoMusic 保姆级教程3 步部署让小爱音箱免费点播全网音乐【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个开源项目核心就一句话让小爱音箱免费听全网音乐。你对着音箱喊播放周杰伦的晴天本地没有这首歌时它会自动调用 yt-dlp 下载下来再播放全程不依赖任何音乐会员 按作者与社区的实测口径语音识别准确率约 98.7%歌曲下载成功率约 95%本地命中时播放响应在 200ms 以内常见小爱型号二十款左右都已验证可用。下面按先跑起来、再玩起来的顺序讲。一、三分钟部署 XiaoMusic一条 Docker 命令加一份最小配置最省事的方式是 Docker只需要挂载两个目录music存音乐、conf存配置并把 58090 映射到容器端口 8090docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic三个注意点/xiaomusic_music和/xiaomusic_conf是主机上的目录没有就先mkdir -p建好58090 可换成任意空闲端口但容器端的 8090 不要动启动后浏览器打开http://NAS_IP:58090进入 Web 后台首次填入小米账号密码并保存才会拉出设备列表。不喜欢 Docker 的话有两条备路pip 用户执行pip install -U xiaomusic再用xiaomusic启动即可配置格式参考 config-example.json源码用户克隆仓库git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic后按开发指南启动核心代码在 xiaomusic/ 目录docs/issues/211.md 里有完整的文档索引。最小配置示例带*的为必填其余都可以在 Web 页面里改{ account: 你的小米账号, password: 你的小米密码, music_path: music, convert_to_mp3: false }music_path建议用绝对路径避免权限问题convert_to_mp3留到第五节再讲它的用途。二、语音点播怎么工作喊歌名后自动下载并本地播放它的机制可以拆成三步每一步都能在真实场景里对上号拦截指令XiaoMusic 绑定你的小米账号后小爱同学播放周杰伦的晴天这类播放请求会先被它接住从指令里解析出歌曲信息先查本地音乐库里能匹配到就直接播放这一步几乎无感知前面说的 200ms 延迟就来自这里没有就下载本地无资源时用 yt-dlp 引擎从主流音乐平台取音频存进本地音乐目录再播放——所以下次点同一首已经是本地命中的速度。内置口令覆盖了日常所需播放歌曲、播放歌曲歌名、上一首/下一首、单曲循环/全部循环/随机播放、播放歌单目录名、加入收藏/取消收藏、停止播放/关机。还有个隐藏玩法直接喊故事名比如播放歌曲小猪佩奇的故事它会先下载再播放儿童内容也能纯语音点播。三、本地音乐库与网络歌单两种曲库来源本地音乐库是基本盘。XiaoMusic 扫描music_path目录支持 mp3、flac、wav、ape、ogg、m4a 六种格式Web 页面可按全部歌曲 / 收藏 / 下载分类浏览支持搜索和删除。网络歌单是增量。你可以配置一个 JSON 格式的歌单电台、歌曲都支持也可以直接用别人分享的歌单链接手里有 m3u 电台文件的话项目自带转换工具能一步转成网络歌单 json入口在 m3u 转换工具。这样音箱的曲库不再只依赖已经下载过什么。四、多设备协同与自定义语音口令进阶玩法家里有多台音箱时XiaoMusic 可以在同一个面板统一管理页面右上角切换目标设备客厅放背景音乐、卧室播儿童故事也支持把多台设备分组播放。语音口令本身是可编程的配置里的user_key_word_dict能把任意词绑定到动作上比如自造晨间唤醒睡前安眠这样的场景口令各自触发 plugins/ 下的脚本code1.py、httpget.py、httppost.py执行内置的key_word_dict关键词表和匹配顺序同样开放在配置里想把放歌换成别的说法改配置就行。五、常见问题与安全提醒连不上、不兼容、公网访问问部署后设备列表不显示先确认小米账号密码正确要在 Web 页面保存后才会拉取设备再检查网络环境Web 设置页底部有【下载日志文件】按钮拿日志排查docs/issues/99.md 是 FAQ 合集多数问题已有答案。问某些格式播不了L05B、L05C、LX06、L16A 等型号不支持 flac把【转换为MP3】和【型号兼容模式】打开即可。问支持哪些设备已验证的包括小爱音箱L06A、Redmi 小爱音箱 PlayL07A、小米AI音箱S12/S12A/MDZ-25-DA、万能遥控版LX5A、Play 2019款LX05、第二代L15A、Xiaomi SoundL16A/Sound ProL17A、ProLX06、miniLX01、PlayL05B/增强版L05C、ArtL09A以及触屏版、智能音箱 Pro 系列等基本覆盖市售主流型号。问音质和海外资源下载默认 mp3想要高音质直接把 flac、wav 等无损文件放进音乐目录播放。资源获取基于 yt-dlp全球主流平台的歌曲、电台都能走同一套下载-播放流程。问长期稳定性关注项目更新日志与 Issue 响应即可。需要说明的是README 顶部公告项目已停止维护作者推荐社区接力项目 songloft新部署前建议把这点纳入考虑。⚠️ 三条安全边界务必记住配置了公网访问一定要开启密码登录并设置复杂密码别在公共场所的 WiFi 环境下使用避免小米账号信息泄露不要使用绑定了摄像头的小米账号——账号一旦泄露监控录像也可能跟着泄露。一句话总结部署一次音箱的曲库从此是你自己攒的——语音点播、本地落盘、免费畅听这就是 XiaoMusic 的全部价值。遇到问题可以去仓库 Issue 区或社区 QQ 群、微信群求助。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考