
小爱音箱播放音乐进阶指南XiaoMusic 从部署到语音点歌完整教程【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你正瘫在沙发上刷手机突然很想听一首很久没碰的老歌喊了声小爱同学它却回你一句没有找到相关歌曲。这种憋屈用过智能音箱的人都懂。XiaoMusic 就是来解决这件事的它是一个让小爱音箱播放音乐真正听你话的开源工具本地库里存了什么它就能放什么库里没有的它还会用 yt-dlp 现下载回来再播。换句话说你的音箱从此不再只会播放它有的歌而是播放你想听的歌。别急着装先看看它能给你带来什么很多人第一眼以为 XiaoMusic 只是个本地播放器遥控器其实它的价值远超预期。先说最让人上头的隐藏玩法你对音箱说一句播放小猪佩奇的故事它会先把音频自动下载下来下载完直接开播。这意味着小爱音箱不再被在线曲库锁死讲故事、听书、找冷门音频统统可以用一句话触发。再说第二个惊喜。你攒了十几年的无损收藏——APE、FLAC、WAV——以前只能插 U 盘或者连蓝牙折腾现在躺在沙发上说一句播放歌曲晴天它会从你的本地库精准匹配、原样推送音质不打折扣全程不用掏手机。第三个价值藏在自动化里定时播放、歌单管理、收藏体系、多台音箱轮流响。装好之后你会发现音箱从一个只能听它给的的盒子变成了一个只听你的的家庭娱乐终端。上图是 XiaoMusic 的 Web 管理界面设备切换、播放控制、歌曲列表都集中在这里入门第一课搞懂小爱音箱播放音乐的幕后链路动手之前先花 30 秒搞懂它的工作链路后面踩坑能少一半。你说一句话 → 小米语音系统识别成文字 → XiaoMusic 接住指令拆出歌手 歌名 动作 → 在本地目录或在线源里找歌 → 把音频推给小爱音箱播放。整条链路里XiaoMusic 干的是传话 调度的活儿而且它需要的东西很简单一台小爱音箱几乎所有在售型号都支持从 Play 到 Sound Pro一个小米账号用来登录并绑定设备一台能常开的 Docker 设备NAS、旧笔记本、迷你主机都行 小贴士如果你的音箱型号偏老比如 L05B、L05C后面配置时记得打开转换为 MP3选项具体原因见文末避坑篇。歌曲列表界面本地库里的歌一目了然支持收藏、下载等分类筛选实战贯通Docker 部署到语音点歌全流程下面这一整段就是从什么都没有到喊一嗓子就能听歌的完整路线照着走即可。第一步给音乐和配置各安一个家mkdir -p /xiaomusic_music mkdir -p /xiaomusic_conf一句话解释一个目录专门放你的歌一个目录专门放配置文件各管各的以后备份也方便。第二步写一份最小的编排文件新建docker-compose.yml内容如下services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf逐行说人话image用的是国内镜像地址拉取更快58090:8090左边是你浏览器访问的端口右边是容器内部端口右边别改volumes把你刚才建的两个目录借进容器让程序读得到歌、存得下配置。第三步启动并确认状态docker-compose up -d docker ps | grep xiaomusic docker logs xiaomusic看到容器状态是 Up就说明服务起来了。然后浏览器打开http://你的设备IP:58090就能看到管理界面。第四步绑定小米账号认领你的音箱这是最核心的一步也是最容易卡住的一步打开设置页输入小米账号和密码保存系统会自动去拉取你账号名下的设备列表刷新页面勾选你想控制的小爱音箱再次保存完成绑定。保存之后建议先往音乐目录里丢一首 mp3让系统扫描一次确认列表里能看到它再往下走。第五步说出你的第一句点歌口令走到音箱前说小爱同学播放歌曲晴天。本地库里有它会立刻响应没有的话试试播放小猪佩奇的故事你会看到它先下载再播放——前面说的隐藏玩法就是这么触发的。到这里小爱音箱播放音乐这条主线已经跑通了。不想用 Docker 的话项目也支持pip install xiaomusic直接启动适合只想在本机试玩的朋友。进阶调教自定义口令、歌单与定时播放主线通了接下来是把它调教成你的形状。自定义语音口令。默认口令已经覆盖了绝大多数场景下一首、上一首、单曲循环、随机播放、停止播放、加入收藏……这些关键词都定义在配置文件里参考项目根目录的 config-example.json你可以按自己的习惯增删替换比如把默认的停止口令改成更顺口的词。歌单即文件夹。XiaoMusic 的规则很朴素一个文件夹就是一个歌单。说播放歌单民谣就播民谣文件夹里的歌说播放歌单第3个就按列表顺序来。配合加入收藏 / 取消收藏日常听歌习惯两句话就能维护好。如果你手里有现成的 m3u 电台文件项目里还带了转换工具可以一键转成它认识的歌单格式细节见 docs/ 下的说明。歌单列表支持展开与收起配合语音口令管理起来很顺手定时播放让音乐叫醒你。项目内置了定时任务模块xiaomusic/crontab.py配置好 cron 表达式后可以做到每天早上 7 点自动响起你选好的歌单晚上到点自动切到助眠曲。设一次长期生效。多台音箱轮流响。家里不止一台小爱音箱时可以在 Web 界面切换当前设备让音乐跟着你从客厅走到卧室切换过程不用重连。高阶玩法用插件扩展小爱音箱的能力边界觉得点歌还不够XiaoMusic 预留了插件机制示例代码就在 plugins/ 目录里里面已经有 httpget、httppost 等现成例子分别用来在触发口令时发起 GET 或 POST 请求。玩法大致是在配置里把一个自定义关键词指向exec#插件名(参数)这样的动作。别被这行字吓到本质上就是说这个词 → 执行这段小脚本门槛很低。你可以让音箱在播放之外顺手开个灯、发条通知或者接上你自己的服务适合喜欢折腾的人慢慢玩。新手最容易踩的 5 个坑坑 1Docker 报错找不到目录。没先建好挂载目录就启动容器会直接退出。解法很朴实先mkdir -p再up -d。坑 2设备列表死活刷不出来。多半是账号或密码有误或者网络环境不对。保存账号信息后一定要刷新页面设备列表才会加载出来。坑 3歌放出来没声音或直接被跳过。大概率是格式兼容问题。已知 L05B、L05C、LX06、L16A 等型号不支持 FLAC去设置里打开【转换为 MP3】和【型号兼容模式】即可解决。坑 4网页打不开。先确认 58090 端口没被占用再看防火墙有没有放行改端口时只改左边右边的 8090 保持原样。坑 5想外网访问却忘了开密码。这是安全底线问题一旦把服务暴露到公网务必开启登录认证并设置复杂密码更稳妥的做法是别在同一小米账号下绑定摄像头等隐私设备防患于未然。长期价值与下一步行动清单回过头看XiaoMusic 解决的不只是让音箱放歌这一件事而是把智能音箱从厂商曲库的租客变成了你私人资源的主人。无损收藏不再吃灰孩子的睡前故事一句话就播早上有音乐准时叫你起床——这些体验叠加起来才是它真正的长期价值。核心优势小结一句话语音点歌歌名、歌手、歌单、收藏等指令齐全本地与在线两条路都通缺的内容自动下载补齐Docker 一键部署主流小爱音箱型号基本都能用插件与定时任务加持扩展空间大、可玩性高下一步行动清单git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic把项目拿到手按实战贯通一节部署并绑定你的音箱往音乐目录丢几首常听的歌等扫描完成喊出第一句播放歌曲……感受响应速度和音质再试一句播放小猪佩奇的故事体验自动下载的隐藏玩法。音乐本来就是拿来享受的别让一句找不到这首歌扫了兴致。把这套东西跑起来剩下的交给你的嘴就够了。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考