小爱音箱播放本地音乐完整指南XiaoMusic 部署、配置与使用实战【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic小爱音箱默认只能点播小米曲库里的内容自己收藏的高品质音乐很难用一句话唤起播放。XiaoMusic 是专门处理这个痛点的开源项目它解析你的语音指令在本地音乐库或在线音源中检索匹配曲目再通过小米服务把音频推送到音箱播放并保留播放、暂停、切歌等全套控制能力。本文将按先认识工具、再完成部署、随后配置指令、接着管理歌单、最后排错与加固的顺序展开覆盖从零到能用的完整链路。在动手之前先把这篇文章能给你的东西说清楚一份可照抄的 Docker 配置文件、一份绑定小米账号的操作清单、一张语音指令速查表以及一套常见故障的排查思路。XiaoMusic 是什么它能解决什么问题一句话定义XiaoMusic 是连接本地音乐库 在线音源与小爱音箱语音系统的桥梁。它本身不负责发声负责的是把你说的话翻译成一次准确的音乐播放动作。一次完整的播放流程包含四个环节解析语音指令识别出歌曲名与歌手名在本地目录或在线平台检索匹配的曲目在线部分通过 yt-dlp 下载通过小米服务把音频推送到音箱执行播放、暂停、切歌等实时控制。它适合两类人一是手里有大量本地音乐、想让音箱直接播的用户二是家里已有小爱音箱、想把它变成语音点播终端的智能家居玩家。它也有边界账号绑定依赖小米服务设备需要与部署机器处于同一局域网且旧款音箱可能需要开启转码才能正常出声。音频格式兼容范围如下表格式定位说明MP3最常用通用性最好几乎所有设备可直接播放FLAC / WAV无损音质适合对音质有要求的收藏场景APE / OGG / M4A小众格式兼容性已覆盖个别设备需注意需要特别留意的是L05B、L05C 这类较旧的小爱音箱型号建议在配置中开启转换为 MP3选项可显著降低播放失败的概率。部署之前需要准备什么XiaoMusic 的部署门槛不高但对环境有一项硬性要求一台能够常开的设备可以是家用电脑也可以是 NAS。它承担两个职责一是存放音乐文件二是持续运行服务以便随时响应音箱请求。启动前建议先建好两个目录职责分开更利于管理音乐目录如 /xiaomusic_music存放 MP3、FLAC 等音频文件配置目录如 /xiaomusic_conf保存配置文件与小米账号相关信息。之所以把两者拆开是为了后续备份、迁移和升级互不干扰。音乐文件不动配置配置文件不动音乐出问题时定位也更清晰。如何用 Docker 完成安装三步走Docker 方式的好处是依赖自动处理无需手动安装 Python 环境和各类音频解码库。整个过程分三步写配置、启动服务、验证状态。第一步创建 docker-compose.yml内容如下version: 3.8 services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf对这份配置做三点说明镜像地址使用的是国内镜像站拉取速度更快端口映射把容器内 8090 映射到宿主机的 58090浏览器访问入口是 http://你的设备IP:58090两个挂载目录分别对应前面建好的音乐目录与配置目录保证容器能读到音乐文件、写回配置文件。第二步在 docker-compose.yml 所在目录执行启动命令docker-compose up -d第三步验证服务状态。查看容器是否正常运行用 docker ps | grep xiaomusic需要了解运行细节时用 docker logs xiaomusic 查看实时日志。日志也是后面排查问题的第一手材料。账号和设备怎么绑定五步完成服务启动后浏览器打开管理界面接下来是连接音箱最关键的一步按下面顺序操作即可在设置页面输入小米账号与密码让系统自动检测局域网 IP确认无误保存配置系统会拉取你的设备列表刷新页面勾选要控制的小爱音箱再次保存确认设备绑定成功。这一步需要注意的是网络环境。整个绑定与后续控制都依赖局域网通信请只在家庭网络内操作不要在公共 Wi-Fi 下输入账号密码以免信息泄露。语音关键词可以自定义吗可以。XiaoMusic 内置了一套默认触发词也允许你在 Web 设置里按自己的说话习惯调整配置项是几个 JSON 键值对{ keywords_playlocal: 播放本地歌曲, keywords_play: 播放歌曲, keywords_playlist: 播放列表, keywords_stop: 停止播放 }比如把 keywords_play 改成给我放那么给我放周杰伦的晴天就会命中播放指令。关键词调整立即生效不用重启服务。绑定完成、关键词就位后下面这张常用口令速查表可以直接收藏备用指令类型说法效果基础控制播放周杰伦的晴天自动检索并播放指定歌曲基础控制下一首 / 上一首切换曲目基础控制单曲循环重复当前曲目基础控制停止播放立即静音停播歌单控制播放歌单流行音乐播放指定名称的歌单歌单控制播放歌单第3个从歌单第 3 首开始播放收藏加入收藏收藏正在播放的歌曲定时30分钟后关机定时关闭音箱一个值得一试的隐藏功能对小爱说播放小猪佩奇的故事XiaoMusic 会自动搜索并下载相关内容后开始播放对家里有孩子的场景很实用这也是在线音源能力yt-dlp 下载的典型用法。歌单与音乐库如何管理XiaoMusic 的音乐来源分两类管理方式也对应不同。本地歌单按文件夹组织你把音乐文件按歌手或专辑分目录放好界面里会自动按文件夹维度呈现等于用目录结构完成了分类。界面上还提供了全部 / 收藏 / 下载等分类标签方便快速过滤。网络歌单则使用 JSON 格式便于分享与导入。文件放在配置目录后会自动识别格式如下{ name: 我的最爱, description: 每日必听歌单, songs: [ {name: 晴天, artist: 周杰伦}, {name: 七里香, artist: 周杰伦}, {name: 告白气球, artist: 周杰伦} ] }除了手动整理系统还会按歌手、专辑、风格做智能分类播放过程中随时说加入收藏当前曲目就会进入收藏列表。列表的折叠交互也做成了手风琴式动画大量歌单时界面依然清爽。有哪些进阶玩法值得尝试基础功能跑通后XiaoMusic 还提供了三条扩展路径。插件扩展。项目预留了插件接口扩展代码统一放在 plugins/ 目录下从在线音乐搜索到歌词展示都可以通过插件补充想自己写扩展也可以从这里入手。多设备协同。家里有多台小爱音箱时可以在 Web 界面切换目标设备让音乐在不同房间之间流转而不是固定在某一台音箱上。定时任务。通过 xiaomusic/crontab.py 模块可以配置定时播放比如早上 7 点用音乐当闹钟或者晚上 10 点自动播放助眠内容。配合30 分钟后关机这类定时指令整晚播放也能自动收尾。移动端控制同样可行。手机浏览器直接访问管理界面即可远程控制社区里也有一些第三方客户端可用包括微信小程序卯卯音乐、手机 App风花雪乐以及电视端肉肉音乐TV选择取决于你常用的终端。遇到问题该怎么排查三个最高频的问题附上对应的排查路径。音箱无法连接。先确认小米账号密码是否正确再确认音箱与部署设备处于同一局域网最后用 docker logs xiaomusic 查看日志中的具体报错信息。三步走完多数连接问题都能定位到原因。音乐无法播放。先确认文件格式是否在支持列表内再检查音乐目录的读写权限确保容器有权限读取。如果音箱型号较旧直接开启转换为 MP3选项这是解决旧款设备播放失败的最快手段。Web 界面无法访问。确认 58090 端口没有被其他进程占用检查宿主机防火墙是否放行该端口最后尝试 docker-compose restart 重启容器。端口、防火墙、进程状态这三项逐一核对即可。长期使用要注意什么XiaoMusic 长期稳定运行建议守住五条底线尽量只在局域网内使用不把服务直接暴露到公网确需公网访问时开启 HTTP 认证并使用高强度密码定期更新 Docker 镜像跟随上游修复与改进定期备份 /xiaomusic_conf 目录账号与配置不丢不要在小爱音箱上绑定摄像头等隐私敏感设备。下一步按这份清单动手如果决定开始使用按以下顺序操作即可克隆项目源码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic创建音乐与配置目录编写 docker-compose.yml执行 docker-compose up -d导入音乐文件浏览器打开管理界面绑定小米账号与音箱先用基础指令验证播放再按习惯调整关键词、导入歌单遇到问题先看 docker logs xiaomusic再对照上文排查清单逐项核对。部署、绑定、播放、扩展每一步都有对应的检查点。把流程走完一遍小爱音箱才真正变成属于你自己的音乐终端。本文采用的【问题清单式】新结构与核心关键词清单核心关键词为小爱音箱本地音乐、XiaoMusic 部署长尾关键词为小爱音箱播放本地音乐、XiaoMusic Docker 部署教程、小爱音箱语音指令配置、XiaoMusic 歌单管理、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 配置文件、一份绑定小米账号的操作清单、一张语音指令速查表以及一套常见故障的排查思路。XiaoMusic 是什么它能解决什么问题一句话定义XiaoMusic 是连接本地音乐库 在线音源与小爱音箱语音系统的桥梁。它本身不负责发声负责的是把你说的话翻译成一次准确的音乐播放动作。一次完整的播放流程包含四个环节解析语音指令识别出歌曲名与歌手名在本地目录或在线平台检索匹配的曲目在线部分通过 yt-dlp 下载通过小米服务把音频推送到音箱执行播放、暂停、切歌等实时控制。它适合两类人一是手里有大量本地音乐、想让音箱直接播的用户二是家里已有小爱音箱、想把它变成语音点播终端的智能家居玩家。它也有边界账号绑定依赖小米服务设备需要与部署机器处于同一局域网且旧款音箱可能需要开启转码才能正常出声。音频格式兼容范围如下表格式定位说明MP3最常用通用性最好几乎所有设备可直接播放FLAC / WAV无损音质适合对音质有要求的收藏场景APE / OGG / M4A小众格式兼容性已覆盖个别设备需注意需要特别留意的是L05B、L05C 这类较旧的小爱音箱型号建议在配置中开启转换为 MP3选项可显著降低播放失败的概率。部署之前需要准备什么XiaoMusic 的部署门槛不高但对环境有一项硬性要求一台能够常开的设备可以是家用电脑也可以是 NAS。它承担两个职责一是存放音乐文件二是持续运行服务以便随时响应音箱请求。启动前建议先建好两个目录职责分开更利于管理音乐目录如 /xiaomusic_music存放 MP3、FLAC 等音频文件配置目录如 /xiaomusic_conf保存配置文件与小米账号相关信息。之所以把两者拆开是为了后续备份、迁移和升级互不干扰。音乐文件不动配置配置文件不动音乐出问题时定位也更清晰。如何用 Docker 完成安装三步走Docker 方式的好处是依赖自动处理无需手动安装 Python 环境和各类音频解码库。整个过程分三步写配置、启动服务、验证状态。第一步创建 docker-compose.yml内容如下version: 3.8 services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf对这份配置做三点说明镜像地址使用的是国内镜像站拉取速度更快端口映射把容器内 8090 映射到宿主机的 58090浏览器访问入口是 http://你的设备IP:58090两个挂载目录分别对应前面建好的音乐目录与配置目录保证容器能读到音乐文件、写回配置文件。第二步在 docker-compose.yml 所在目录执行启动命令docker-compose up -d第三步验证服务状态。查看容器是否正常运行用 docker ps | grep xiaomusic需要了解运行细节时用 docker logs xiaomusic 查看实时日志。日志也是后面排查问题的第一手材料。账号和设备怎么绑定五步完成服务启动后浏览器打开管理界面接下来是连接音箱最关键的一步按下面顺序操作即可在设置页面输入小米账号与密码让系统自动检测局域网 IP确认无误保存配置系统会拉取你的设备列表刷新页面勾选要控制的小爱音箱再次保存确认设备绑定成功。这一步需要注意的是网络环境。整个绑定与后续控制都依赖局域网通信请只在家庭网络内操作不要在公共 Wi-Fi 下输入账号密码以免信息泄露。语音关键词可以自定义吗可以。XiaoMusic 内置了一套默认触发词也允许你在 Web 设置里按自己的说话习惯调整配置项是几个 JSON 键值对{ keywords_playlocal: 播放本地歌曲, keywords_play: 播放歌曲, keywords_playlist: 播放列表, keywords_stop: 停止播放 }比如把 keywords_play 改成给我放那么给我放周杰伦的晴天就会命中播放指令。关键词调整立即生效不用重启服务。绑定完成、关键词就位后下面这张常用口令速查表可以直接收藏备用指令类型说法效果基础控制播放周杰伦的晴天自动检索并播放指定歌曲基础控制下一首 / 上一首切换曲目基础控制单曲循环重复当前曲目基础控制停止播放立即静音停播歌单控制播放歌单流行音乐播放指定名称的歌单歌单控制播放歌单第3个从歌单第 3 首开始播放收藏加入收藏收藏正在播放的歌曲定时30分钟后关机定时关闭音箱一个值得一试的隐藏功能对小爱说播放小猪佩奇的故事XiaoMusic 会自动搜索并下载相关内容后开始播放对家里有孩子的场景很实用这也是在线音源能力yt-dlp 下载的典型用法。歌单与音乐库如何管理XiaoMusic 的音乐来源分两类管理方式也对应不同。本地歌单按文件夹组织你把音乐文件按歌手或专辑分目录放好界面里会自动按文件夹维度呈现等于用目录结构完成了分类。界面上还提供了全部 / 收藏 / 下载等分类标签方便快速过滤。网络歌单则使用 JSON 格式便于分享与导入。文件放在配置目录后会自动识别格式如下{ name: 我的最爱, description: 每日必听歌单, songs: [ {name: 晴天, artist: 周杰伦}, {name: 七里香, artist: 周杰伦}, {name: 告白气球, artist: 周杰伦} ] }除了手动整理系统还会按歌手、专辑、风格做智能分类播放过程中随时说加入收藏当前曲目就会进入收藏列表。列表的折叠交互也做成了手风琴式动画大量歌单时界面依然清爽。有哪些进阶玩法值得尝试基础功能跑通后XiaoMusic 还提供了三条扩展路径。插件扩展。项目预留了插件接口扩展代码统一放在 plugins/ 目录下从在线音乐搜索到歌词展示都可以通过插件补充想自己写扩展也可以从这里入手。多设备协同。家里有多台小爱音箱时可以在 Web 界面切换目标设备让音乐在不同房间之间流转而不是固定在某一台音箱上。定时任务。通过 xiaomusic/crontab.py 模块可以配置定时播放比如早上 7 点用音乐当闹钟或者晚上 10 点自动播放助眠内容。配合30 分钟后关机这类定时指令整晚播放也能自动收尾。移动端控制同样可行。手机浏览器直接访问管理界面即可远程控制社区里也有一些第三方客户端可用包括微信小程序卯卯音乐、手机 App风花雪乐以及电视端肉肉音乐TV选择取决于你常用的终端。遇到问题该怎么排查三个最高频的问题附上对应的排查路径。音箱无法连接。先确认小米账号密码是否正确再确认音箱与部署设备处于同一局域网最后用 docker logs xiaomusic 查看日志中的具体报错信息。三步走完多数连接问题都能定位到原因。音乐无法播放。先确认文件格式是否在支持列表内再检查音乐目录的读写权限确保容器有权限读取。如果音箱型号较旧直接开启转换为 MP3选项这是解决旧款设备播放失败的最快手段。Web 界面无法访问。确认 58090 端口没有被其他进程占用检查宿主机防火墙是否放行该端口最后尝试 docker-compose restart 重启容器。端口、防火墙、进程状态这三项逐一核对即可。长期使用要注意什么XiaoMusic 长期稳定运行建议守住五条底线尽量只在局域网内使用不把服务直接暴露到公网确需公网访问时开启 HTTP 认证并使用高强度密码定期更新 Docker 镜像跟随上游修复与改进定期备份 /xiaomusic_conf 目录账号与配置不丢不要在小爱音箱上绑定摄像头等隐私敏感设备。下一步按这份清单动手如果决定开始使用按以下顺序操作即可克隆项目源码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic创建音乐与配置目录编写 docker-compose.yml执行 docker-compose up -d导入音乐文件浏览器打开管理界面绑定小米账号与音箱先用基础指令验证播放再按习惯调整关键词、导入歌单遇到问题先看 docker logs xiaomusic再对照上文排查清单逐项核对。部署、绑定、播放、扩展每一步都有对应的检查点。把流程走完一遍小爱音箱才真正变成属于你自己的音乐终端。本文采用的【问题清单式】新结构与核心关键词清单核心关键词为小爱音箱本地音乐、XiaoMusic 部署长尾关键词为小爱音箱播放本地音乐、XiaoMusic Docker 部署教程、小爱音箱语音指令配置、XiaoMusic 歌单管理、XiaoMusic 常见问题排查。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考