XiaoMusic 快速上手指南3分钟让小爱音箱播放你所有的音乐【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个跑在 NAS 或服务器上的开源音乐服务器专治小爱音箱只能听别人家歌单的毛病。接上它之后你的本地 MP3 能播、网上没下过的歌说歌名就能下载着播还能用语音切换下一首、切播放模式、管理歌单全程在网页后台点几下就能完成。一、它能帮你做什么先给你一张能力清单看完就知道值不值得装本地音乐播放把 mp3、flac、wav、ape、ogg、m4a 文件丢进音乐目录每个子文件夹自动变成一个歌单在线找歌对小爱说播放歌曲歌名本地没有就先下载再播用的是 xiaomusic/online_music.py 里的 yt-dlp 下载逻辑语音口令下一首、上一首、单曲循环、随机播放、播放歌单、加入收藏、N分钟后关机口令词还能自己改网页控制台搜索、试听、删歌、换设备、看播放进度不用翻配置文件多设备管理家里几台音箱都能纳管按房间分组播放网络歌单电台、m3u8 流媒体都能配进歌单自带 m3u 转 JSON 工具常见小爱音箱型号都已适配不确定的可以查 docs/issues/99.md 里的 FAQ型号设备名称L06A小爱音箱L05B / L05C小爱音箱 Play / 增强版LX06小爱音箱 ProL16A / L17AXiaomi Sound / Sound ProLX04 / X10A触屏版音箱LX01小爱音箱 mini二、3 分钟部署Docker 一条命令跑起来有 Docker 的话一条命令就能启动国内网络可换成docker.hanxi.cc/hanxi/xiaomusic镜像源docker run -d --name xiaomusic -p 58090:8090 -v ./music:/app/music -v ./conf:/app/conf --restart always hanxi/xiaomusic⚠️ 两个目录不存在会报错先执行mkdir -p ./music ./conf。启动后浏览器打开http://NAS_IP:58090在设置页填入小米账号密码保存后设备列表会自动出现勾选你要用的音箱就完事了。did 这类设备参数全自动获取不需要手动填。关键参数就这几个其余在网页上按需改即可参数作用说明58090:8090端口映射58090 随意改8090 是容器端口别动./music:/app/music音乐目录放本地歌和下载的歌建议独立分区./conf:/app/conf配置目录自动生成的 setting.json 存在这里定期备份--restart always自启动断电、重启后自动恢复想从源码跑也行git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install pdm run xiaomusic.py所有可调项参考 config-example.json比如music_path、convert_to_mp3、edge_tts_voice等。三、核心功能逐个体验3.1 本地音乐库文件放进去就能播你把音乐目录按歌手/专辑或任意层级组织XiaoMusic 会递归扫描深度默认 10 层每层每个目录都识别为一个播放列表所以歌手名直接就成了你能语音点播的歌单名。在设置里打开文件监听enable_file_watch新文件拷进来几秒后就会出现在列表里不用手动刷新。下载的歌曲统一存在music/download子目录和你自己的歌互不干扰。3.2 在线找歌没有的歌说歌名就下本地没有的歌直接对小爱说播放歌曲 周杰伦 晴天。系统先在本地搜搜不到就走在线下载流程搜到资源 → 下载成 mp3 → 存进 download 目录 → 播放。整个过程音箱会先说下载中几十秒后开始放歌。想限制搜索渠道的话配置里的search_prefix默认是bilisearch:可以换成别的下载站前缀。下载失败一般是源站接口变动更新一下版本通常就恢复了。3.3 语音控制口令词可以随便改语音功能的原理是后台每秒拉一次小爱的对话记录命中口令就打断音箱原来的播放流程、接管控制权。所以默认口令必须带播放歌曲这个前缀你直接说播放音乐它是不认的。内置口令覆盖日常场景切歌、切模式单曲循环/全部循环/随机播放/顺序播放、播放指定歌单、收藏/取消收藏、删除歌曲、X分钟后关机。嫌默认的不顺手可以在key_word_dict里加自己的词比如给放歌也映射到播放指令key_match_order决定多个口令同时出现时先匹配谁。识别还有模糊匹配兜底阈值默认 0.6个别字说错也能命中。 一个隐藏玩法说播放歌曲小猪佩奇的故事这种本地没有的内容会触发下载后再播给孩子放睡前故事很方便。3.4 多设备管理一台一台管也能分组播后台右上角可以切换当前操作的音箱界面和播放列表都会跟着切。登录小米账号后所有设备自动列出来勾选即可纳管group_list配置里填设备分组按客厅、卧室这类房间分就能对一组音箱下同一份播放指令。 注意播放时音箱必须能访问到服务器hostname要填 NAS 的局域网 IP音箱只认 IPv4别填 localhost。设置页有自动填 IP 和端口按钮一键搞定。四、进阶玩法网络歌单设置页支持填一个 JSON 歌单电台m3u8和普通歌曲都能装进去电台条目加type:radio就会一直播不切歌。示例[{name: 电台歌单, musics: [ {name: 央广, url: http://xxx/index.m3u8, type: radio} ]}]已有的 m3u 电台文件可以用自带的转换工具一键转成这种 JSON。更多格式示例见 docs/issues/78.md。插件扩展plugins/ 目录内置了httpget、httppost等 Python 插件js_plugin_runner.js负责跑 JS 插件。你可以通过自定义口令调用它们比如把测试链接映射到exec#httpget(...)等于给音箱加自定义技能。个性化配置语音提示音默认用小米 TTS登陆失败就换成 Edge-TTSedge_tts_voice默认zh-CN-XiaoyiNeural切歌有前几秒重叠把下一首歌延迟播放秒数调成负数提前结束上一首拉对话记录太频繁导致登录掉线用定时任务配置早晚开关比如早 6 点开、晚 12 点关触屏音箱想显示歌名歌词封面打开启用继续播放五、常见问题与避坑现象原因解法后台看不到设备登录失败Login failed关代理在局域网内用 mi.com 重新登录一次米家 App 退出重登仍不行用 cookie 登录网页能播、语音没反应获取对话记录开关没开设置页打开语音口令开关首次保存 did 后要重启容器音箱没声音hostname/端口填错或跨网段用自动填按钮填 IP确认音箱和 NAS 同局域网防火墙放行FLAC 播不了L05B、L05C、LX06、L16A 等型号不支持 flac打开转换为 MP3或提前批量转码列表里没有歌目录没挂对、权限不对、文件夹名不是 UTF-8检查挂载和目录编码点刷新列表暂停后又自动播只说了暂停定时器还在说关机才能真正停掉播放循环排查问题最快的路是看日志设置页底部点【下载日志文件】 提 issue 前先搜一遍里面别带账号密码或者容器环境里docker logs -f xiaomusic看实时输出。大部分历史问题都能在 FAQ 集合里搜到答案。⚠️ 两条安全底线把服务暴露到公网时务必开启密码登录并设复杂密码别把绑了小爱音箱的小米账号同时绑摄像头账号泄露会连带隐私一起走。六、写在最后一台几十块钱的小爱音箱加一个容器就能变成家里随叫随到的私人音乐中心——本地曲库、在线补货、语音点播、多房播放四件事全占了。需要提醒的是作者已宣布停止维护该项目、由社区接手接力但现有功能稳定日常使用不受影响。装上之后第一句口令建议就试播放歌曲听到音乐响的那一刻这 3 分钟就算没白花。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考