快速上手小爱音箱音乐播放xiaomusic 的部署与日常使用指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic小爱音箱音乐播放是一个开源工具把电脑或 NAS 上的本地音乐推到小爱音箱播放也能用 yt-dlp 下载网络歌曲同时保留小爱同学的语音交互。它主要服务于想在自家小爱音箱上脱离内置曲库的用户。本文按最快部署方式、其余方式怎么选、实际怎么用、兼容速查的顺序把部署和日常操作一次讲清。 项目速览一句话定位xiaomusic 是小爱音箱的第三方音乐播放服务本地曲库与网络资源都能播语音口令照常工作。核心能力如下播放本地音乐文件音乐库放在 NAS 或任意 Linux 目录即可用 yt-dlp 下载在线歌曲或电台边下边播保留小爱音箱原生语音交互口令可自定义提供 Web 控制台管理播放列表、歌单与设备支持 JSON 格式网络歌单附 M3U 转换工具插件机制可扩展主题与新功能源码见 plugins/它绕开的是音箱内置音乐服务的曲库限制音量、语音唤醒等原生能力不受影响。 最快上手3 步用 Docker 跑起来最省事的路径是 Docker 部署不需要准备 Python 环境3 步完成。复制配置模板cp config-example.json config.json。编辑config.json填入小米账号信息与音箱设备 DID端口保持默认 8090 即可。启动容器docker run -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic浏览器打开http://你的IP:58090就能进入控制台。注意 58090 是你本机的映射端口8090 是容器内端口不建议改动。 其他部署方式怎么选另一条路径是 Python 环境适合想改源码、写插件的人长期跑在服务器上的生产环境则推荐 Docker Compose。三种方式对照如下方式适合人群一句话说明Docker 一行命令新手、NAS 用户免依赖群晖、威联通等主流 NAS 都能跑Docker Compose生产环境自动重启、数据持久化、便于升级与多服务编排pip 安装 Python 版开发者pip install -U xiaomusic后执行xiaomusic --config config.json便于调试与二次开发更详细的文档与历史问题记录可查 docs/issues/ 目录。 按场景使用下面按三个常见场景说明日常怎么用覆盖本地播放、在线下载和纯语音操作。场景一播放本地音乐。把音乐文件放进挂载的/app/music目录后控制台会自动扫描出全部歌曲按所有歌曲 / 收藏 / 下载分类浏览支持搜索、双击即播、删除与收藏。场景二下载并播放在线歌曲。对小爱说播放歌曲某某服务会调用 yt-dlp 在线下载再播放给家里孩子放故事音频也走同样的路径首次等待稍长之后走本地缓存。场景三纯语音控制不动控制台。常用口令包括播放歌曲上一首/下一首停止播放单曲循环/全部循环/随机播放播放歌单收藏加入收藏/取消收藏。此外网络歌单用 JSON 配置即可自定义主题分类M3U 电台文件可以转换后直接接入。 设备与格式兼容速查设备兼容情况以官方已验证列表为准更多型号可查看 docs/issues/ 中的讨论记录设备型号设备名称支持状态L06A小爱音箱完全支持L07ARedmi小爱音箱 Play完全支持LX06小爱音箱Pro完全支持L16AXiaomi Sound完全支持LX01小爱音箱mini完全支持音频格式支持 MP3、FLAC、WAV、APE、OGG、M4A。注意L05B、L05C、LX06、L16A 这几个型号播放 FLAC 需要开启转换为 MP3选项否则可能无声。 常见故障排查遇到卡点时按下面的速查表处理多数问题出在配置而不是代码启动正常但无法控制音箱 → 确认音箱与服务在同一局域网核对配置中的设备 DID再重启音箱与服务重试播放状态正常但无声音 → 检查音箱音量是否被调低确认文件格式受支持换一首歌测试日志里看播放状态在线下载失败 → 检查网络连通性确认 yt-dlp 已正确安装必要时更换下载源或配置代理下载目录写入失败 → 检查挂载目录的写入权限公网访问有安全顾虑 → 开启密码登录并设置复杂口令避免把音箱与摄像头等敏感设备绑定播放 FLAC 无反应 → 对应型号开启转换为 MP3后重放写在最后如果打算长期用现在就按 Docker 方式在 NAS 上建好挂载目录并验证一次播放。需要说明的是xiaomusic 已停止维护不再接受新功能与 bug 修复有新需求建议迁移到社区接力项目 songloft-org/songloft。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考