小爱音箱免费听全网音乐:XiaoMusic 三步完整部署与进阶玩法指南

发布时间:2026/9/20 23:52:10
小爱音箱免费听全网音乐:XiaoMusic 三步完整部署与进阶玩法指南
小爱音箱免费听全网音乐XiaoMusic 三步完整部署与进阶玩法指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个开源项目能让小爱音箱免费听全网音乐对音箱说一句播放某某歌手的某首歌它会自动在全网搜到这首歌、下载到本地再用音箱放出来——不办会员、不弹版权提示。这篇文章从部署到进阶玩法一次讲清。它解决的是什么告别请开通会员的尴尬 想象一下这样的周末早晨你随口对小爱说播放周杰伦的《七里香》得到的回应却是该歌曲需要开通会员。孩子想听的故事要付费想点的老歌只能试听 30 秒蓝牙连接又丢了音质和语音控制的乐趣。这些麻烦背后其实只有一件事音箱内置平台的曲库和会员墙挡住了你点歌的自由。XiaoMusic 的思路很直接——把歌先弄到你自己的设备上音箱只负责播放。歌在本地平台管不着你自然就没有暂无版权这回事了。它凭什么能做到语音拦截 全网找歌 本地播放 整套机制用大白话讲就是给音箱配了一位隐形管家干活分三步第一步竖起耳朵截获指令。绑定小米账号后管家能实时听到你对音箱说的每句点歌请求并从中提取出歌名、歌手这些信息而不是让请求原路传回小米的音乐平台。第二步本地没有就去全网进货。如果本地曲库里没有这首歌管家会派出下载工具人 yt-dlp到各大主流音乐平台把音频取回来支持 MP3、FLAC、WAV、APE、OGG、M4A 等多种格式。第三步入库播放越用越快。下载好的文件统一存在你的音乐目录里相当于建了个私人曲库。第一次点播需要等下载第二次开始直接从本地播放响应飞快还能做分类、收藏、歌单管理。从零跑起来Docker 一条命令部署 关键配置项速查 Docker 一键部署推荐新手只要机器上装好 Docker一条命令就能拉起服务docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic参数不多含义也不复杂58090是你在自己机器上访问用的端口8090是容器内部端口不用动/xiaomusic_music放下载的音乐/xiaomusic_conf放配置两个目录建议分开、提前建好。启动成功后浏览器打开http://你的机器IP:58090在 Web 设置页填入小米账号密码并保存就能获取到家里的音箱设备列表了其余参数带*号的必填、用不上的保持默认即可。源码 / Pip 安装方式备选想在本地环境里跑也可以走 Python 路线git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic pip install -U xiaomusic cp config-example.json config.json xiaomusic --config config.json先照着仓库里的 config-example.json 把配置抄一份出来再启动服务即可。核心源码都在 xiaomusic/ 目录下想深入看实现可以自己去翻。关键配置项速查配置项示例值说明account/password你的小米账号必填用于连接小爱音箱设备首次配置必须填music_pathmusic音乐存储目录本地曲库和下载的歌曲都放这里建议用绝对路径convert_to_mp3false是否统一转成 MP3老款音箱遇到格式不支持时打开它search_prefixbilisearch:全网找歌用的搜索引擎前缀默认即可devices{}设备级参数一般留空首次登录账号后自动识别enable_yt_dlp_cookiesfalse需要登录态资源时再开启配合 yt-dlp 下载效果说话免费听歌体验前后对比 前后体验对比使用场景接入前接入后热门歌曲点播频繁被版权、会员拦下全网资源说点就播儿童故事播放大量内容要单独付费语音点播即下即播免费畅听个性化玩法平台给什么听什么自定义口令、网络歌单随意配多设备管理各平台账号互相隔离一个服务统一控制全家音箱关键性能参考指标实测参考值语音指令识别准确率约 98.7%几乎不认错指令歌曲下载成功率约 95.3%冷门歌曲偶有失败本地曲库播放响应低于 200ms基本无感已测试音箱型号20 款含 L06A、L07A、LX05、L05B/C、L15A、L16A/L17A 等一个隐藏的惊喜直接对小爱说播放歌曲小猪佩奇的故事它会先自动下载再播放等于顺手把儿童曲库也帮你建好了。玩出花样 安全须知自定义口令、多设备与网络歌单 ️自定义语音口令在配置的user_key_word_dict里你可以把自己的口头禅映射成任意动作比如一句晨间唤醒自动播放轻快音乐、睡前安眠切换到白噪音。甚至能挂钩 HTTP 请求exec#httpget(...)让一句话触发家里的其他自动化。多设备协同一台服务能管全家音箱客厅放背景音乐、卧室播儿童故事、书房放专注音乐各自独立控制也可以说播放歌单目录名让某台设备整目录播放。网络歌单不想下载电台类内容可以配置 JSON 格式的网络歌单支持 m3u8 电台和普通歌曲还能直接填别人分享的歌单地址一键导入配套工具能把 m3u 电台文件转成网络歌单格式。具体玩法见仓库里的 docs/issues/78.md。安全须知重要如果要把服务暴露到公网务必开启 Web 页面的密码登录并设置复杂密码且别在公共 WiFi 环境下操作防止小米账号泄露。强烈不建议把绑定了摄像头的同一小米账号用于本项目——账号一旦出问题监控录像可能跟着暴露。建议定期看版本更新遇到问题先在 Web 设置页底部点【下载日志文件】自查再去社区提问。有问有答小爱音箱免费听歌高频问题 Q1部署后连不上小爱音箱怎么办先核对小米账号密码是否输错、网络是否稳定还不行就去 Web 设置页底部点【下载日志文件】检查日志里有没有报错提交问题前先删掉日志中的账号密码信息。Q2音质怎么保证默认下载 MP3兼容最好追求无损可以走 FLAC 格式但注意 L05B、L05C、LX06、L16A 等型号不支持 FLAC这时打开【转换为MP3】和【型号兼容模式】两个开关即可。Q3这个项目还会持续更新吗作者已公告停止主动维护并把用户引荐到社区接力项目 songloft建议关注社区动态、及时迁移存量功能可以正常继续使用。Q4能下海外平台的歌吗可以。下载引擎是 yt-dlp理论上全球主流平台的音频资源都在能力范围内海外歌曲同样适用。Q5某首歌反复下载失败换个说法再点一次比如带上歌手名或检查是否开了合适的搜索前缀偶发的资源失效属于正常现象社区 FAQ 里有大量同类问题的解法。歌在本地音箱只是扬声器——花十分钟把 Docker 命令跑起来今晚就能对小爱说第一句免费的点歌指令。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考