xiaomusic小爱音箱播放本地音乐3 条部署路径与避坑指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic晚饭刚收完你对着音箱说小爱同学播放周杰伦的晴天可它自带的曲库有限想听的歌不一定在库里。xiaomusic 是一个免费开源的小爱音箱音乐播放工具部署在 NAS 或一台常开的电脑上就能让音箱播放本地曲库也支持在线搜歌下载即播小爱同学的语音交互完整保留。本文面向想把自己的音箱变成私人音乐库的用户讲清部署路径、功能用法和几个容易踩的坑。 小爱音箱音乐播放xiaomusic 能帮你做什么播放本地曲库音乐目录指向 NAS 或电脑Web 控制台自动扫描按专辑、歌手分类播放在线资源下载一句口令用 yt-dlp 搜索并下载网络歌曲后直接播放语音控制保留点播、切歌、收藏、循环都可以直接对小爱同学说可扩展语音口令可自定义支持写 JS 插件网络歌单、电台也能接 选一条路把音箱音乐服务跑起来官方提供 Docker 镜像本地跑则支持 pip 安装。按你的环境挑一条有 NAS群晖、威联通等直接走 Docker两条命令起步——mkdir -p /xiaomusic_music /xiaomusic_conf docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic只想本地跑执行pip install -U xiaomusic参考根目录的config-example.json复制出一份config.json再用xiaomusic --config config.json启动默认端口 8090。要长期挂机用 Docker Compose。仓库 README 里有带restart: always的现成模板改两个挂载目录即可conf 存配置、music 存音乐容器升级不丢数据。启动后在浏览器打开http://你的IP:58090进入 Web 控制台。首次使用需要在设置页填入小米账号密码并保存才能拉取到设备列表。 按场景用功能语音点播、曲库管理与下载语音点播日常基本被口令覆盖——播放歌曲晴天下一首单曲循环/随机播放播放歌单收藏加入收藏。关键词可在配置里重新映射改成你顺口的说法。本地曲库管理控制台扫描 mp3、flac、wav、ape、ogg、m4a 格式分成全部歌曲/收藏/下载等标签双击任意一首即可在当前选中的设备上播放。在线资源下载说在线播放 歌名即可边下边播README 里还有个隐藏玩法对小爱说播放歌曲小猪佩奇的故事会自动下载故事音频再播放给孩子听很方便。网络歌单与插件支持指向 JSON 格式的网络歌单电台也可以仓库自带 m3u 转 JSON 工具想扩展功能可以在 plugins/ 目录写 JS 插件用法细节见 docs/。⚠️ 小爱音箱部署容易踩的坑设备列表拉不到、音箱连不上最常见原因是设置页没填小米账号或音箱和跑服务的机器不在同一局域网。先到设置页确认账号密码已保存再确认两者在同一网段。FLAC 播放没声音L05B、L05C、LX06、L16A 等型号不支持原生 flac 播放。在 Web 设置里打开转换为 MP3和型号兼容模式播放前会自动转码。Docker 报找不到 xiaomusic_music 目录挂载目录在宿主机上不存在先执行mkdir -p /xiaomusic_music /xiaomusic_conf再启动容器。 进阶与社区语音口令、播放模式、TTS 回复话术都能在config.json里自定义更完整的文档和问题集合在 docs/ 目录维护。社区里还有第三方 Web 主题、移动端播放器和微信小程序等周边想读源码可以从xiaomusic/主目录入手。现在就试的话最快的路径是 NAS 上跑 Docker两条命令启动Web 页填好账号然后对小爱说一句播放歌曲。注作者已宣布该项目停止维护如需持续更新建议迁移到社区接力项目 songloft-org/songloft。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考