小爱音箱秒变私人点歌台XiaoMusic从零到进阶的Docker部署保姆级指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你是否也曾经对着家里的小爱音箱喊破喉咙播放周杰伦的晴天结果它只会回答没有找到相关资源而你手机里明明存着几百首无损音乐却束手无策XiaoMusic 正是为解决这个痛点而生的开源项目——一个把小爱音箱变成私人点歌台的音乐播放桥梁支持语音点播本地音乐库还能通过 yt-dlp 自动下载在线音乐。今天我就把从零部署到进阶玩法的经验完完整整分享给你。它能为你做什么先看看这张价值清单在动手之前我想先用三句话讲清楚 XiaoMusic 到底值不值得你折腾因为它和市面上那些智能音箱控制工具有本质区别价值点大白话解释谁最需要它语音点播本地音乐说播放歌曲某某某音箱就从你硬盘里找歌收藏了大量无损音乐、不想被会员墙困住的人在线音乐自动下载说播放小猪佩奇的故事它先用 yt-dlp 下载再播放有娃家庭、想听有声内容的人全格式兼容支持 MP3、FLAC、WAV、APE、OGG、M4A手头音乐格式五花八门的囤歌党多设备管理一个后台同时控制家里好几台小爱音箱家里多房间都摆了音箱的智能家居玩家简单说它做的就是把语音指令翻译成播放动作中间的搜索、下载、推送全自动完成。如果你手头正好有一台吃灰的小爱音箱或者嫌手机连蓝牙放歌太麻烦那它就是你今天最值得装的东西。最快上手路径5分钟让小爱音箱跑起来整个部署过程其实比我预想的简单得多Docker 已经把依赖全打包好了。你只需要按下面三步走。第 1 步建两个目录给音乐和配置安个家mkdir -p /xiaomusic_music /xiaomusic_conf这段命令的作用分别创建音乐存放目录和配置存放目录后面 Docker 会把这两个目录挂载进容器这样你往音乐目录里丢歌音箱就能直接播。第 2 步写一份 docker-compose.ymlservices: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf这段命令的作用58090:8090是把容器内的 8090 端口映射到你电脑的 58090 端口restart: always保证服务崩溃后自动拉起两个挂载目录分别对应音乐库和配置。如果你下载镜像慢用docker.hanxi.cc/hanxi/xiaomusic这个国内镜像会快很多。第 3 步一键启动并完成初始化docker-compose up -d这段命令的作用后台拉取镜像并启动容器。等十几秒后打开浏览器访问http://你的设备IP:58090你就看到 Web 管理界面了。接下来在设置页里填上小米账号和密码保存——注意这一步超关键必须先保存账号密码系统才能拿到你的设备列表。刷新页面后勾选你要控制的小爱音箱再次保存大功告成小贴士如果你用的是 NAS把上面的 IP 换成 NAS 的局域网地址即可要是容器报错找不到目录多半是宿主机目录还没建好回头补一下第 1 步就行。深度玩法拆解三个让人直呼真香的功能跑通基础功能只是开始下面这三个玩法才是 XiaoMusic 真正拉开差距的地方我挑最值得的讲。玩法一给语音口令改头换面让小爱听懂你的习惯项目内置了一套口令映射表比如播放歌曲下一首单曲循环等但每个人说话习惯不一样。好在这些关键词完全可以自定义——在 Web 设置里就能改或者直接编辑配置文件里的key_word_dict字段key_word_dict: { 下一首: play_next, 单曲循环: set_play_type_one, 加入收藏: add_to_favorites }这段配置的作用把下一首映射到切换歌曲的命令把单曲循环映射到循环模式命令。你甚至可以给同一个动作绑定多个说法比如关机暂停停止都指向stop命令怎么顺口怎么来。举个栗子我家娃总说换一首歌我就把换一首也加进了play_next的映射里从此小爱再也不会一脸茫然。玩法二网络歌单 m3u 转换电台资源随手接XiaoMusic 支持 JSON 格式的网络歌单格式非常简单任何人都能看懂{ name: 我的最爱, description: 每日必听歌单, songs: [ {name: 晴天, artist: 周杰伦}, {name: 七里香, artist: 周杰伦} ] }这段配置的作用定义一个歌单歌单里每条记录是一首歌的歌名和歌手。把这样的文件放到配置目录刷新后就能对小爱说播放歌单我的最爱。更妙的是项目还内置了 m3u 文件转换工具——网上那些 m3u 电台列表拷进来一键转成 JSON 歌单等于你的音箱瞬间多出几百个在线电台。玩法三定时任务让音乐替你叫醒每个早晨除了被动点歌XiaoMusic 还能主动放歌。通过定时任务配置对应源码里的crontab.py你可以设定某个时刻自动播放指定歌单。我现在的日常是工作日早上 7:30 音箱自动放起轻音乐当闹钟比手机闹铃温柔多了。避坑指南新手最容易踩的四个坑下面这些坑我基本都亲测踩过按现象→原因→解法帮你一次排清。坑一点播的 FLAC 歌曲音箱死活不出声现象本地歌曲明明能搜到但播放时没声音或直接报错。原因部分老型号音箱如 L05B、L05C、LX06、L16A不支持 FLAC 无损格式。解法在设置里打开【转换为 MP3】和【型号兼容模式】让 XiaoMusic 先把音频转成音箱能认的格式再推过去。坑二服务暴露到公网后账号安全提心吊胆现象在外网也能访问管理界面但总觉得小米账号密码在裸奔。原因默认情况下 Web 界面没有密码保护公网可达等于门户大开。解法一旦配置公网访问务必开启 HTTP 认证并设置复杂密码强烈不建议在公共 WiFi 下配置也别把音箱账号绑定摄像头等隐私设备。坑三歌词、歌手信息对不上搜歌经常张冠李戴现象说播放周杰伦的晴天播出来的却是别的版本。原因本地音乐文件的 ID3 标签信息缺失或混乱导致匹配出错。解法用工具把音乐文件的歌名、歌手标签整理规范开启模糊匹配后只要相似度达标默认阈值 0.6就能命中不用一字不差。坑四docker 启动报错找不到挂载目录现象docker-compose up -d后容器反复重启日志提示找不到目录。原因宿主机上/xiaomusic_music和/xiaomusic_conf还不存在。解法先执行第 1 步的mkdir -p命令建好目录再启动。记住宿主机路径随便改容器内的/app/music和/app/conf千万别动。⚠️注意遇到疑难问题时去 Web 设置页底部点【下载日志文件】把日志里的小米账号密码等敏感信息删掉后再去社区提问这样开发者能更快帮你定位。下一步行动清单现在就动手看到这里你的小爱音箱离私人点歌台只差最后几步了克隆项目git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic把源码和文档留在本地随时查阅快速上手按上文三步完成 Docker 部署配置小米账号并绑定音箱尝试高级功能自定义语音口令、导入网络歌单、配置定时任务让音箱真正懂你参与社区遇到问题翻翻项目里的 FAQ 文档docs/issues/99.md想深入了解实现原理可以看看核心源码xiaomusic/command_handler.py。最后说一句掏心窝的话XiaoMusic 最打动我的地方是它让科技感落回了日常——你不需要记住任何复杂操作只要像跟朋友说话一样把想听的歌告诉小爱剩下的它都替你安排好了。音乐本就该是生活里最没有门槛的享受去把它装起来吧让那句播放周杰伦的晴天从此有求必应。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
