企业官网建设流程全解析

xiaomusic 小爱音箱音乐播放：5分钟跑起来

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

xiaomusic 是一款开源的小爱音箱音乐播放工具：把 NAS（常年开机的家用存储小服务器）或电脑里的本地音乐交给小爱音箱播放，也能用 yt-dlp（一个开源的在线音视频下载工具）在线搜歌、下载后再播。它解决的是音箱只能放会员平台曲库的尴尬，同时保留了"小爱同学"的语音交互，适合家里有闲置小爱音箱、想要自由音乐库的你。

🎧 能帮你做到什么

先看这个小爱音箱音乐播放工具能干什么，再决定值不值得占 NAS 一个位置。

• 本地音乐进音箱：mp3、flac 等格式，网页点一点就能放
• 在线搜歌：用 yt-dlp 下载网络歌曲，下完直接播
• 语音控制：播放、切歌、单曲循环、随机播放都能说
• 歌单与收藏：按目录分歌单，说"播放歌单收藏"反复听
• 多设备：一台主机同时管多台小爱音箱

🐳 5分钟跑起来

不想看文档直接照做，推荐方式就一种：Docker（把软件和依赖打包好的部署方式，装好直接跑，不用配 Python 环境）。

1. 准备一台长期开机的设备（NAS、Linux 小主机都行），装好 Docker
2. 建两个空目录，分别存音乐和配置：

   mkdir -p /xiaomusic_music /xiaomusic_conf

3. 启动容器：

   docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

4. 打开 http://NAS_IP:58090（NAS_IP 换成你的设备地址），填小米账号密码保存，设备列表就出来了
5. 往 music 目录丢几首歌，对音箱说"播放歌曲"试试

🎤 日常怎么用

装好之后，真正方便的是这几个日常瞬间。

• 当你想听本地收藏的老歌时，只需把歌放进 music 目录，说"播放歌曲+歌名"，切歌、随机播放也都是嘴上的事
• 当你想听网上没下载过的歌时，只需说"播放歌曲+歌名"，它会先下载再播，给孩子放故事音频也是这个用法
• 当你想固定听某些歌时，只需说"加入收藏"，之后"播放歌单收藏"就能反复循环

🧩 玩出花样

想让口令更贴自己的习惯，改配置就行。

"播放歌曲"这个前缀和每句口令都能自定义；插件目录里有现成的 Python 示例，比如让一条口令触发一次 HTTP 请求（向服务器发送数据的小程序），可以参考着写自己的口令脚本，示例见 plugins/。

⚠️ 踩坑速查表

出问题先对号入座。

后台看不到设备

• 现象：登录报错
• 原因：账号验证被拦截
• 解决：小米官网重新登录，或关代理再试

网页能播，语音没反应

• 现象：说口令没反应
• 原因：语音口令开关没开
• 解决：设置页打开【获取对话记录】

日志显示播放，没声音

• 现象：有记录没声音
• 原因：音箱够不到服务地址
• 解决：检查 hostname 是否填局域网 IP

写在最后

项目目前已停止维护，新需求可以关注社区接力的 songloft 项目；现有部署不受影响，能继续正常使用。遇到报错先看仓库里的 FAQ，基本都能查到答案：docs/issues/99.md。

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