小爱音箱播放音乐完整指南XiaoMusic 从部署到语音点歌一步到位【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你对着小爱音箱说播放周杰伦的晴天它却回你一句没有找到这首歌曲。这不是音箱笨而是它还没连上你的音乐库。XiaoMusic 就是为解决这个痛点而生的开源项目它的核心功能是让小爱音箱播放本地音乐和在线资源你只需开口点歌切歌、建歌单、定时关机全都交给它。下面这份完整指南会带你把它从零部署到真正玩转。如果你手头有一台吃灰的小爱音箱又攒了一堆舍不得删的本地音乐那么这篇文章正好适合你。整个过程就像给音箱开一家自助点唱机音乐文件是货架上的唱片小米账号是入场券Docker 容器是点唱机的机身。接下来我们一步步把它组装起来。开始之前先清点你的家底动手之前请先对照这份清单确认三样东西一台能联网的小爱音箱、一台能运行 Docker 的主机NAS、迷你主机或 Linux 服务器都可以、以及绑定了音箱的小米账号。硬件门槛并不高主流型号如 L05B、L06A、L15A、LX06、触屏版音箱都在支持列表内。前置条件具体要求备注小爱音箱任意常见型号老款 L05B、新款 Xiaomi Sound 均可Docker 环境支持 Docker / Docker Compose群晖、绿联、威联通等 NAS 开箱即用小米账号与音箱绑定的同一个账号用于自动发现局域网内的设备音乐文件MP3、FLAC、WAV、APE、OGG、M4A没有现成音乐也能在线下载空闲端口建议 58090用于浏览器访问管理界面小贴士国内网络环境下建议优先使用镜像docker.hanxi.cc/hanxi/xiaomusic拉取速度快很多海外用户直接用官方镜像hanxi/xiaomusic即可。两种写法在后面都会给出。第一步给音乐库和配置目录各安一个家XiaoMusic 运行时需要两个角色分明的目录一个专门放音乐文件一个专门存配置文件。把它们分开以后备份和迁移都会省心很多。mkdir -p /xiaomusic_music # 音乐库目录放你所有的歌曲文件 mkdir -p /xiaomusic_conf # 配置目录存放账号信息和各种设置预期结果执行后你会在宿主机上看到两个空目录。它们会分别挂载到容器里的/app/music和/app/conf这两个容器内路径是固定的不要改动。第二步用 Docker Compose 拉起服务在任意位置新建一个docker-compose.yml内容如下services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic # 国内镜像海外可换成 hanxi/xiaomusic container_name: xiaomusic restart: always # 开机自启进程挂了自动拉起 ports: - 58090:8090 # 宿主机 58090 映射容器 8090 volumes: - /xiaomusic_music:/app/music # 音乐目录挂载 - /xiaomusic_conf:/app/conf # 配置目录挂载保存后在文件所在目录执行启动命令docker compose up -d # 后台启动容器首次会自动拉取镜像预期结果稍等片刻执行docker ps | grep xiaomusic能看到容器处于 Up 状态。此时打开浏览器访问http://你的主机IP:58090就能看到 XiaoMusic 的 Web 管理界面了。第三步绑定小米账号让音箱认亲容器跑起来只是第一步真正让音箱听话的关键在于账号绑定。这一步的逻辑是XiaoMusic 拿着你的小米账号去小米云端换取权限从而控制局域网内绑定在同一账号下的所有音箱。操作路径很直观进入 Web 界面的「账号设置」页输入小米账号和密码并保存稍等片刻系统会拉取你的设备列表刷新页面在「小爱设备控制」中勾选你想要控制的那台音箱再次点击保存完成绑定预期结果界面左侧的设备列表中出现你的音箱型号右侧出现本机和音箱两个可切换的播放目标。此时你已经完成了全流程中最关键的一步——音箱正式认亲成功。第四步把音乐灌进去建立你的歌单体系账号绑好后往/xiaomusic_music里扔几首歌试试。XiaoMusic 会自动扫描该目录并按照文件夹结构自动生成歌单比如你在里面建一个民谣文件夹界面上就会多出一个民谣歌单。支持按歌手名、专辑名组织目录整理得越清晰语音点歌的命中率越高。预期结果回到界面点击「刷新列表」或者直接对小爱说刷新列表歌曲列表会按你放入的目录结构展示出来。你还可以在这里试听、删除歌曲、把喜欢的歌加入收藏。第五步说出第一句语音指令验收成果现在对你的小爱音箱说出那句准备了很久的话播放歌曲周杰伦的晴天如果一切顺利音箱会回一句好的然后立刻开始播放。到这一步你的自助点唱机已经正式营业了。不妨把下面的常用口令挨个试一遍感受一下语音控制的完整度语音口令作用播放歌曲 歌名按歌名搜索并播放本地音乐上一首 / 下一首切换歌曲单曲循环 / 全部循环 / 随机播放切换播放模式播放歌单 目录名播放指定歌单加入收藏 / 取消收藏维护收藏歌单30分钟后关机定时停止播放小贴士如果找不到本地音乐先检查文件是不是放在/xiaomusic_music下、格式是否在上述支持列表内再对小爱说一句刷新列表即可。进阶玩法让点唱机更懂你的四个技巧基础功能已经打通接下来这些技巧能让整个体验再上一个台阶建议收藏备用。技巧一自定义语音关键词。默认口令不习惯在 Web 设置的「关键词」区域可以自由调整。比如把触发词改成放歌把停止播放改成别唱了还能通过user_key_word_dict给口令绑定自定义动作完全按你的说话习惯来。技巧二接入网络歌单。项目支持 JSON 格式的网络歌单可以放电台地址也可以直接使用别人分享的歌单链接配套的 m3u 转换工具还能把常见的 m3u 电台文件一键转成 XiaoMusic 能识别的 JSON 格式操作方式可以参考 docs/issues/78.md。技巧三用定时任务做音乐闹钟。想每天早上被音乐叫醒配置crontab_json即可实现定时播放到点自动响歌晚上也能设置助眠播放听完自动安静。相关实现位于 xiaomusic/crontab.py配置示例可在 config-example.json 中找到。技巧四用插件和自定义口令扩展能力。项目内置了插件机制plugins/目录下的 Python 脚本可以注册成自定义口令例如把测试自定义口令映射到执行exec#code1(hello)。这意味着你可以让音箱响应任意脚本——查天气、报新闻、讲段子只要你想得到。进阶提示多台音箱的家庭可以在界面右上角随时切换播放设备让音乐在不同房间之间流转配合收藏功能全家人的口味可以各存各的歌单。踩坑与解决方案常见问题对账清单教程写得再顺实际使用中难免遇到状况。下面把社区里出现频率最高的问题整理成对账清单遇到哪个对哪个。问题现象解决方案保存账号后拿不到设备列表确认账号密码无误且音箱与该账号绑定点击保存后稍等片刻再刷新页面语音说播放歌曲却提示找不到检查音乐文件是否在挂载目录内、格式是否受支持然后对小爱说刷新列表部分无损音乐播放失败或无声L05B、L05C、LX06、L16A 等型号不支持 FLAC去设置里开启转换为 MP3和型号兼容模式在线歌曲点了搜索却迟迟不出现网络下载需要时间耐心等待进度下载慢时可检查代理配置proxy是否生效容器启动了但网页打不开确认端口 58090 未被占用、防火墙放行或执行docker logs xiaomusic查看启动日志打算从公网访问担心账号泄露务必关闭disable_httpauth并设置复杂密码不要在公共 WiFi 环境下配置账号如果你遇到的问题不在表里最有效的排查方式是去 Web 设置页底部点击「下载日志文件」先自行确认日志里没有账号密码等敏感信息再带上日志去项目 Issues 反馈维护者通常回复很快。下一步给你一份明确的行动清单到这里整套流程已经走完最后帮你把行动项收敛成一张可勾选的清单创建/xiaomusic_music和/xiaomusic_conf两个目录编写docker-compose.yml并执行docker compose up -d浏览器访问http://主机IP:58090绑定小米账号并选择音箱往音乐库放入第一批歌曲建立自己的目录歌单对着音箱说出播放歌曲 歌名完成第一次语音点歌按需尝试进阶技巧关键词定制、网络歌单、定时任务、插件扩展如果你想从源码跑起来也可以在任意目录执行git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic拿到完整项目参考 README 中的 Pip 安装方式运行。一台音箱的价值往往不取决于它本身有多聪明而取决于你愿意花多少心思去喂它。XiaoMusic 就是那把钥匙把你的音乐库、你的歌单、你的作息习惯全部装进那句简简单单的播放歌曲里。现在就去动手吧让家里的点唱机从今天开始真正为你一个人营业。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 小爱音箱播放音乐完整指南：XiaoMusic 从部署到语音点歌一步到位
小爱音箱播放音乐完整指南XiaoMusic 从部署到语音点歌一步到位【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你对着小爱音箱说播放周杰伦的晴天它却回你一句没有找到这首歌曲。这不是音箱笨而是它还没连上你的音乐库。XiaoMusic 就是为解决这个痛点而生的开源项目它的核心功能是让小爱音箱播放本地音乐和在线资源你只需开口点歌切歌、建歌单、定时关机全都交给它。下面这份完整指南会带你把它从零部署到真正玩转。如果你手头有一台吃灰的小爱音箱又攒了一堆舍不得删的本地音乐那么这篇文章正好适合你。整个过程就像给音箱开一家自助点唱机音乐文件是货架上的唱片小米账号是入场券Docker 容器是点唱机的机身。接下来我们一步步把它组装起来。开始之前先清点你的家底动手之前请先对照这份清单确认三样东西一台能联网的小爱音箱、一台能运行 Docker 的主机NAS、迷你主机或 Linux 服务器都可以、以及绑定了音箱的小米账号。硬件门槛并不高主流型号如 L05B、L06A、L15A、LX06、触屏版音箱都在支持列表内。前置条件具体要求备注小爱音箱任意常见型号老款 L05B、新款 Xiaomi Sound 均可Docker 环境支持 Docker / Docker Compose群晖、绿联、威联通等 NAS 开箱即用小米账号与音箱绑定的同一个账号用于自动发现局域网内的设备音乐文件MP3、FLAC、WAV、APE、OGG、M4A没有现成音乐也能在线下载空闲端口建议 58090用于浏览器访问管理界面小贴士国内网络环境下建议优先使用镜像docker.hanxi.cc/hanxi/xiaomusic拉取速度快很多海外用户直接用官方镜像hanxi/xiaomusic即可。两种写法在后面都会给出。第一步给音乐库和配置目录各安一个家XiaoMusic 运行时需要两个角色分明的目录一个专门放音乐文件一个专门存配置文件。把它们分开以后备份和迁移都会省心很多。mkdir -p /xiaomusic_music # 音乐库目录放你所有的歌曲文件 mkdir -p /xiaomusic_conf # 配置目录存放账号信息和各种设置预期结果执行后你会在宿主机上看到两个空目录。它们会分别挂载到容器里的/app/music和/app/conf这两个容器内路径是固定的不要改动。第二步用 Docker Compose 拉起服务在任意位置新建一个docker-compose.yml内容如下services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic # 国内镜像海外可换成 hanxi/xiaomusic container_name: xiaomusic restart: always # 开机自启进程挂了自动拉起 ports: - 58090:8090 # 宿主机 58090 映射容器 8090 volumes: - /xiaomusic_music:/app/music # 音乐目录挂载 - /xiaomusic_conf:/app/conf # 配置目录挂载保存后在文件所在目录执行启动命令docker compose up -d # 后台启动容器首次会自动拉取镜像预期结果稍等片刻执行docker ps | grep xiaomusic能看到容器处于 Up 状态。此时打开浏览器访问http://你的主机IP:58090就能看到 XiaoMusic 的 Web 管理界面了。第三步绑定小米账号让音箱认亲容器跑起来只是第一步真正让音箱听话的关键在于账号绑定。这一步的逻辑是XiaoMusic 拿着你的小米账号去小米云端换取权限从而控制局域网内绑定在同一账号下的所有音箱。操作路径很直观进入 Web 界面的「账号设置」页输入小米账号和密码并保存稍等片刻系统会拉取你的设备列表刷新页面在「小爱设备控制」中勾选你想要控制的那台音箱再次点击保存完成绑定预期结果界面左侧的设备列表中出现你的音箱型号右侧出现本机和音箱两个可切换的播放目标。此时你已经完成了全流程中最关键的一步——音箱正式认亲成功。第四步把音乐灌进去建立你的歌单体系账号绑好后往/xiaomusic_music里扔几首歌试试。XiaoMusic 会自动扫描该目录并按照文件夹结构自动生成歌单比如你在里面建一个民谣文件夹界面上就会多出一个民谣歌单。支持按歌手名、专辑名组织目录整理得越清晰语音点歌的命中率越高。预期结果回到界面点击「刷新列表」或者直接对小爱说刷新列表歌曲列表会按你放入的目录结构展示出来。你还可以在这里试听、删除歌曲、把喜欢的歌加入收藏。第五步说出第一句语音指令验收成果现在对你的小爱音箱说出那句准备了很久的话播放歌曲周杰伦的晴天如果一切顺利音箱会回一句好的然后立刻开始播放。到这一步你的自助点唱机已经正式营业了。不妨把下面的常用口令挨个试一遍感受一下语音控制的完整度语音口令作用播放歌曲 歌名按歌名搜索并播放本地音乐上一首 / 下一首切换歌曲单曲循环 / 全部循环 / 随机播放切换播放模式播放歌单 目录名播放指定歌单加入收藏 / 取消收藏维护收藏歌单30分钟后关机定时停止播放小贴士如果找不到本地音乐先检查文件是不是放在/xiaomusic_music下、格式是否在上述支持列表内再对小爱说一句刷新列表即可。进阶玩法让点唱机更懂你的四个技巧基础功能已经打通接下来这些技巧能让整个体验再上一个台阶建议收藏备用。技巧一自定义语音关键词。默认口令不习惯在 Web 设置的「关键词」区域可以自由调整。比如把触发词改成放歌把停止播放改成别唱了还能通过user_key_word_dict给口令绑定自定义动作完全按你的说话习惯来。技巧二接入网络歌单。项目支持 JSON 格式的网络歌单可以放电台地址也可以直接使用别人分享的歌单链接配套的 m3u 转换工具还能把常见的 m3u 电台文件一键转成 XiaoMusic 能识别的 JSON 格式操作方式可以参考 docs/issues/78.md。技巧三用定时任务做音乐闹钟。想每天早上被音乐叫醒配置crontab_json即可实现定时播放到点自动响歌晚上也能设置助眠播放听完自动安静。相关实现位于 xiaomusic/crontab.py配置示例可在 config-example.json 中找到。技巧四用插件和自定义口令扩展能力。项目内置了插件机制plugins/目录下的 Python 脚本可以注册成自定义口令例如把测试自定义口令映射到执行exec#code1(hello)。这意味着你可以让音箱响应任意脚本——查天气、报新闻、讲段子只要你想得到。进阶提示多台音箱的家庭可以在界面右上角随时切换播放设备让音乐在不同房间之间流转配合收藏功能全家人的口味可以各存各的歌单。踩坑与解决方案常见问题对账清单教程写得再顺实际使用中难免遇到状况。下面把社区里出现频率最高的问题整理成对账清单遇到哪个对哪个。问题现象解决方案保存账号后拿不到设备列表确认账号密码无误且音箱与该账号绑定点击保存后稍等片刻再刷新页面语音说播放歌曲却提示找不到检查音乐文件是否在挂载目录内、格式是否受支持然后对小爱说刷新列表部分无损音乐播放失败或无声L05B、L05C、LX06、L16A 等型号不支持 FLAC去设置里开启转换为 MP3和型号兼容模式在线歌曲点了搜索却迟迟不出现网络下载需要时间耐心等待进度下载慢时可检查代理配置proxy是否生效容器启动了但网页打不开确认端口 58090 未被占用、防火墙放行或执行docker logs xiaomusic查看启动日志打算从公网访问担心账号泄露务必关闭disable_httpauth并设置复杂密码不要在公共 WiFi 环境下配置账号如果你遇到的问题不在表里最有效的排查方式是去 Web 设置页底部点击「下载日志文件」先自行确认日志里没有账号密码等敏感信息再带上日志去项目 Issues 反馈维护者通常回复很快。下一步给你一份明确的行动清单到这里整套流程已经走完最后帮你把行动项收敛成一张可勾选的清单创建/xiaomusic_music和/xiaomusic_conf两个目录编写docker-compose.yml并执行docker compose up -d浏览器访问http://主机IP:58090绑定小米账号并选择音箱往音乐库放入第一批歌曲建立自己的目录歌单对着音箱说出播放歌曲 歌名完成第一次语音点歌按需尝试进阶技巧关键词定制、网络歌单、定时任务、插件扩展如果你想从源码跑起来也可以在任意目录执行git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic拿到完整项目参考 README 中的 Pip 安装方式运行。一台音箱的价值往往不取决于它本身有多聪明而取决于你愿意花多少心思去喂它。XiaoMusic 就是那把钥匙把你的音乐库、你的歌单、你的作息习惯全部装进那句简简单单的播放歌曲里。现在就去动手吧让家里的点唱机从今天开始真正为你一个人营业。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考