小爱音箱如何播放本地音乐一份 20 分钟走完的 XiaoMusic 部署教程【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic晚上九点你想听一首压箱底的老歌于是对小爱说播放歌曲周杰伦晴天它却回你一句暂时没有版权。想让小爱音箱播放本地音乐其实不用换音箱也不用买会员一个叫 XiaoMusic 的开源项目就能做到把你收藏的歌曲变成音箱的曲库语音一说就播。这篇文章会把整个落地过程拆成几步照着做即可。为什么你的小爱音箱总说没有版权先看清问题小爱音箱默认只能播放版权合作方曲库里的歌。歌一旦下架、受地区限制或者你手里的是自己抓轨的无损文件音箱就没有版权了。问题的本质不在歌而在播放源只要把播放源从云端曲库换成你自己控制的目录一切就都通了。XiaoMusic 解决的就是这个源的问题——它是一个运行在 NAS 或电脑上的服务让小爱音箱的语音指令直接指向你的音乐文件。XiaoMusic 是怎么让小爱音箱播放本地音乐的原理一句话就能说清它站在小爱和你收藏的音乐之间当翻译官。你对音箱说播放歌曲某某某请求先被它接住然后它去本地目录和网络歌单里找歌找到了直接推送播放找不到就调用 yt-dlp 现场下载再交给音箱出声。整个过程你无感知体验上跟点播云歌单没有区别。它支持的音频格式覆盖主流场景mp3、flac、wav、ape、ogg、m4a 都能被扫描进曲库无损文件也能直接播。这张黑胶既是你收藏的音乐也是 XiaoMusic 眼中的曲库XiaoMusic Docker 部署教程准备目录、写编排文件、启动容器部署只需要三件事两个目录、一个 compose 文件、一条启动命令。设备上只要有 Docker 环境就行群晖、威联通、软路由、普通电脑皆可。建好两个目录音乐与配置分开存mkdir -p /xiaomusic_music mkdir -p /xiaomusic_confmusic 目录放歌曲文件conf 目录放配置和账号信息。分开存的好处是以后升级容器、重装系统时音乐和配置都不受影响。如果启动时提示找不到目录多半是漏了这一步。写一份最简 docker-compose 配置新建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几个参数解释一下58090:8090中 58090 是你设备上对外开放的端口可以按喜好改成别的但 8090 是容器内部端口不要动两个 volume 把宿主机目录挂进容器/app/music和/app/conf是容器内路径同样不要改。如果拉取镜像速度不理想把镜像地址换成hanxi/xiaomusic试试。启动容器并用浏览器确认页面docker compose up -d docker ps | grep xiaomusic看到容器处于 Up 状态后浏览器打开http://你的设备IP:58090出现管理界面就说明服务起来了。想看运行细节用docker logs xiaomusic。进入管理页后设备控制、播放列表、账号设置都在左侧导航里小爱音箱语音点歌设置绑定小米账号与选择设备网页能打开只是第一步让音箱认识你才是关键。流程如下进入设置页面填入小米账号和密码保存。这一步会向小米服务请求你账号下的设备列表。刷新页面在设备列表里勾选你家里那台小爱音箱。市面上常见型号基本都在支持范围内。再次保存等待设备状态变为在线。亲测提示如果设备列表是空的先确认手机上的小爱音箱 App 用的就是这个账号并且音箱与部署设备在同一局域网内。另外配置过程会用到小米账号密码请只在可信的家庭网络里操作。日常使用口令、曲库与收藏绑定完成后就可以验收成果了。下面这些口令都是音箱直接能听懂的基础播放播放歌曲或播放歌曲歌名比如播放歌曲周杰伦晴天上一首下一首切歌关机或停止播放结束播放。播放模式单曲循环全部循环随机播放。歌单管理播放歌单目录名播放某个文件夹播放歌单第几个列表名精确跳转播放歌单收藏播放收藏列表。收藏加入收藏把当前歌曲收进收藏歌单取消收藏移除。一个值得试的隐藏玩法对小爱说播放歌曲小猪佩奇的故事它会先帮你下载好内容再播放家里有孩子的可以试。曲库列表里可以看到本机扫描出的所有歌曲按全部、所有歌曲、收藏、下载分类展示进阶小爱音箱网络歌单配置、定时播放与插件曲库目录之外的玩法主要集中在三块。网络歌单支持 JSON 格式的歌单文件放到配置目录后会被自动识别。最简单的结构是这样{ name: 我的最爱, description: 每日必听, songs: [ {name: 晴天, artist: 周杰伦}, {name: 七里香, artist: 周杰伦} ] }它也能解析电台链接还内置了 m3u 格式转换工具可以把现成的 m3u 电台文件转成歌单 JSON导入门槛不高。定时播放项目里提供了定时任务模块参考xiaomusic/crontab.py可以配置早上几点用音乐当闹钟、晚上几点播助眠曲这类固定场景。插件扩展plugins/目录保留了插件接口在线搜索、歌词等扩展能力都可以从这里接进去。想要更丰富的控制体验社区也有多种前端主题和移动端配套可用。歌单按下载、全部、所有歌曲、收藏折叠展开交互一目了然小爱音箱部署常见问题排查清单音箱没反应先看账号密码是否填对、设备是否同一局域网再用docker logs xiaomusic看日志。设置页底部有下载日志文件按钮排查时直接下载日志最省事。能播歌但某些格式放不出来部分型号如 L05B、L05C、LX06、L16A不支持 flac去设置里打开转换为MP3和型号兼容模式即可。网页打不开确认端口 58090 没被占用检查宿主机防火墙是否放行了该端口。提示找不到音乐目录回到第一步执行mkdir -p建目录后再启动。要公网访问务必开启登录密码并设置足够复杂的密码同时不要用同一个小米账号绑定摄像头等隐私设备防止账号泄露引发更大的问题。收尾一份可执行的行动清单建好/xiaomusic_music与/xiaomusic_conf两个目录把歌曲文件放进去写好docker-compose.yml并执行docker compose up -d浏览器打开http://你的设备IP:58090确认页面可访问设置里绑定小米账号、勾选你的音箱型号并再次保存对小爱说播放歌曲试试口令再按需配置网络歌单、定时任务与插件想研究源码和插件样例可以执行git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic把仓库拉到本地。到这一步你的小爱就不再只是一台会员曲库播放器而是真正属于你自己的点歌台。下一步把最常听的那几十首歌丢进目录从今晚开始验收吧。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 小爱音箱如何播放本地音乐？一份 20 分钟走完的 XiaoMusic 部署教程
小爱音箱如何播放本地音乐一份 20 分钟走完的 XiaoMusic 部署教程【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic晚上九点你想听一首压箱底的老歌于是对小爱说播放歌曲周杰伦晴天它却回你一句暂时没有版权。想让小爱音箱播放本地音乐其实不用换音箱也不用买会员一个叫 XiaoMusic 的开源项目就能做到把你收藏的歌曲变成音箱的曲库语音一说就播。这篇文章会把整个落地过程拆成几步照着做即可。为什么你的小爱音箱总说没有版权先看清问题小爱音箱默认只能播放版权合作方曲库里的歌。歌一旦下架、受地区限制或者你手里的是自己抓轨的无损文件音箱就没有版权了。问题的本质不在歌而在播放源只要把播放源从云端曲库换成你自己控制的目录一切就都通了。XiaoMusic 解决的就是这个源的问题——它是一个运行在 NAS 或电脑上的服务让小爱音箱的语音指令直接指向你的音乐文件。XiaoMusic 是怎么让小爱音箱播放本地音乐的原理一句话就能说清它站在小爱和你收藏的音乐之间当翻译官。你对音箱说播放歌曲某某某请求先被它接住然后它去本地目录和网络歌单里找歌找到了直接推送播放找不到就调用 yt-dlp 现场下载再交给音箱出声。整个过程你无感知体验上跟点播云歌单没有区别。它支持的音频格式覆盖主流场景mp3、flac、wav、ape、ogg、m4a 都能被扫描进曲库无损文件也能直接播。这张黑胶既是你收藏的音乐也是 XiaoMusic 眼中的曲库XiaoMusic Docker 部署教程准备目录、写编排文件、启动容器部署只需要三件事两个目录、一个 compose 文件、一条启动命令。设备上只要有 Docker 环境就行群晖、威联通、软路由、普通电脑皆可。建好两个目录音乐与配置分开存mkdir -p /xiaomusic_music mkdir -p /xiaomusic_confmusic 目录放歌曲文件conf 目录放配置和账号信息。分开存的好处是以后升级容器、重装系统时音乐和配置都不受影响。如果启动时提示找不到目录多半是漏了这一步。写一份最简 docker-compose 配置新建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几个参数解释一下58090:8090中 58090 是你设备上对外开放的端口可以按喜好改成别的但 8090 是容器内部端口不要动两个 volume 把宿主机目录挂进容器/app/music和/app/conf是容器内路径同样不要改。如果拉取镜像速度不理想把镜像地址换成hanxi/xiaomusic试试。启动容器并用浏览器确认页面docker compose up -d docker ps | grep xiaomusic看到容器处于 Up 状态后浏览器打开http://你的设备IP:58090出现管理界面就说明服务起来了。想看运行细节用docker logs xiaomusic。进入管理页后设备控制、播放列表、账号设置都在左侧导航里小爱音箱语音点歌设置绑定小米账号与选择设备网页能打开只是第一步让音箱认识你才是关键。流程如下进入设置页面填入小米账号和密码保存。这一步会向小米服务请求你账号下的设备列表。刷新页面在设备列表里勾选你家里那台小爱音箱。市面上常见型号基本都在支持范围内。再次保存等待设备状态变为在线。亲测提示如果设备列表是空的先确认手机上的小爱音箱 App 用的就是这个账号并且音箱与部署设备在同一局域网内。另外配置过程会用到小米账号密码请只在可信的家庭网络里操作。日常使用口令、曲库与收藏绑定完成后就可以验收成果了。下面这些口令都是音箱直接能听懂的基础播放播放歌曲或播放歌曲歌名比如播放歌曲周杰伦晴天上一首下一首切歌关机或停止播放结束播放。播放模式单曲循环全部循环随机播放。歌单管理播放歌单目录名播放某个文件夹播放歌单第几个列表名精确跳转播放歌单收藏播放收藏列表。收藏加入收藏把当前歌曲收进收藏歌单取消收藏移除。一个值得试的隐藏玩法对小爱说播放歌曲小猪佩奇的故事它会先帮你下载好内容再播放家里有孩子的可以试。曲库列表里可以看到本机扫描出的所有歌曲按全部、所有歌曲、收藏、下载分类展示进阶小爱音箱网络歌单配置、定时播放与插件曲库目录之外的玩法主要集中在三块。网络歌单支持 JSON 格式的歌单文件放到配置目录后会被自动识别。最简单的结构是这样{ name: 我的最爱, description: 每日必听, songs: [ {name: 晴天, artist: 周杰伦}, {name: 七里香, artist: 周杰伦} ] }它也能解析电台链接还内置了 m3u 格式转换工具可以把现成的 m3u 电台文件转成歌单 JSON导入门槛不高。定时播放项目里提供了定时任务模块参考xiaomusic/crontab.py可以配置早上几点用音乐当闹钟、晚上几点播助眠曲这类固定场景。插件扩展plugins/目录保留了插件接口在线搜索、歌词等扩展能力都可以从这里接进去。想要更丰富的控制体验社区也有多种前端主题和移动端配套可用。歌单按下载、全部、所有歌曲、收藏折叠展开交互一目了然小爱音箱部署常见问题排查清单音箱没反应先看账号密码是否填对、设备是否同一局域网再用docker logs xiaomusic看日志。设置页底部有下载日志文件按钮排查时直接下载日志最省事。能播歌但某些格式放不出来部分型号如 L05B、L05C、LX06、L16A不支持 flac去设置里打开转换为MP3和型号兼容模式即可。网页打不开确认端口 58090 没被占用检查宿主机防火墙是否放行了该端口。提示找不到音乐目录回到第一步执行mkdir -p建目录后再启动。要公网访问务必开启登录密码并设置足够复杂的密码同时不要用同一个小米账号绑定摄像头等隐私设备防止账号泄露引发更大的问题。收尾一份可执行的行动清单建好/xiaomusic_music与/xiaomusic_conf两个目录把歌曲文件放进去写好docker-compose.yml并执行docker compose up -d浏览器打开http://你的设备IP:58090确认页面可访问设置里绑定小米账号、勾选你的音箱型号并再次保存对小爱说播放歌曲试试口令再按需配置网络歌单、定时任务与插件想研究源码和插件样例可以执行git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic把仓库拉到本地。到这一步你的小爱就不再只是一台会员曲库播放器而是真正属于你自己的点歌台。下一步把最常听的那几十首歌丢进目录从今晚开始验收吧。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考