企业官网建设流程全解析

让小爱音箱随便点歌：XiaoMusic 开源音乐播放方案配置指南

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

XiaoMusic 是一款面向小爱音箱的开源音乐播放方案：部署到局域网后，通过语音指令即可点播全网音乐，歌曲由 yt-dlp 在后台自动下载并存到本地。本文覆盖 Docker 部署、语音指令与兼容设备说明。

🎯 它解决了什么

小爱音箱原生只能播放订阅平台内的内容，常出现"没有版权、无法播放"的情况。XiaoMusic 接管播放链路后，歌曲先搜索、下载为本地文件再播放，音箱不再受单一音源限制，语音交互方式保持不变，说歌名即可切换曲目或播放歌单。

🐳 快速部署配置

用 Docker Compose 部署只需几分钟，NAS、树莓派、家用电脑均可运行。容器启动后，在 Web 页面输入小米账号密码并保存，即可获取设备列表；音乐目录与配置目录建议分开挂载。

services: xiaomusic: image: hanxi/xiaomusic ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

跑通后打开浏览器即可使用。

🎤 语音指令速查表

保留原生的语音交互，高频指令如下：

🖥️ Web 管理与界面主题

后端基于 Python 与 FastAPI 构建，Web 页面可查看播放列表、管理歌单、查看下载进度，歌曲列表支持搜索、删除，开启歌词开关后可全屏查看歌词。界面提供默认主题、Pure、Tailwind、SoundSpace 等风格，按需切换即可。

📱 设备兼容一览

以上为代表性型号，完整兼容列表见项目文档。

两个典型用法

家庭日常：把晨间歌单设为定时任务，音箱在固定时间播放轻音乐或新闻；来客时直接语音点歌，系统自动下载并播放，无需手动操作。

学习专注：单独建一个纯器乐歌单，写作业或工作时播放，音量调低，营造安静的背景环境。

🔒 排错与安全要点

常见问题的处理思路：

• 音箱无响应：确认设备与服务器同网段
• 下载失败：检查网络与代理设置
• 歌曲无法播放：开启转换为MP3兼容模式
• 暴露公网：务必开启密码登录
• 账号隔离：小米账号勿绑定摄像头

社区与扩展

项目内置 JS 插件机制，可自行扩展音乐源与播放器能力。社区已有现成配套应用：微信小程序"卯卯音乐"、手机 APP"风花雪乐"、安卓 TV 端"肉肉音乐TV"。

上手配置

需要更多配置项或查看实现，可直接克隆仓库研究：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic

项目定位为学习与研究用途，使用下载的音频资源时请留意版权合规，避免商业用途。

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic