Xiaomusic 完整指南：小爱音箱播放任意音乐

Xiaomusic 完整指南小爱音箱播放任意音乐【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你问小爱来首 2000 年的老摇滚它回一句没找到NAS 里塞满的本地音乐却永远碰不到它。xiaomusic 的思路很直接在局域网里搭一台本地音乐服务器把小爱音箱接到你的自建曲库上网上没有的歌再用 yt-dlp 现下现播。下面从零把部署和配置步骤走一遍。它是怎么做到的家里多开一座本地电台这节回答封闭的音箱系统凭什么能播你的歌。小爱音箱默认只认自家曲库你整理的收藏没有入口只能听它说暂不支持。xiaomusic 的架构可以类比成在家里搭一座 24 小时电台NAS 是发射机挂载出来的 music 目录是曲库小爱音箱只是收音机。你说播放某首歌服务器先去曲库里翻找到就把播放链接发给音箱曲库没有就先用 yt-dlp 把 mp3 下载到 music 目录再播。音箱始终只连着这座电台播什么由你定。图注官方标注的控制台示意图能看到设备切换、播放列表、进度条和设备音量条各在哪个位置第一次进后台对照着点不迷路。Xiaomusic 怎么部署两种安装方法都跑通这节解决从 0 到后台可访问的问题。方式一Docker 一条命令推荐目标在 NAS 或任何装好 Docker 的机器上起一个服务容器。docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic成功标志浏览器打开http://主机IP:58090能看到 web 控制台在设置页输入小米账号密码并保存页面拉出设备列表就算跑通。方式二pip 手动安装适合开发者准备 Python 环境确认系统装了 ffmpeg音频转换依赖它which ffmpeg查不到就先装。执行pip install -U xiaomusic装好程序。参考仓库里的 config-example.json 写一份config.json。运行xiaomusic --config config.json启动默认监听 8090 端口。浏览器访问http://localhost:8090验证页面/docs可看接口文档。卡住了先查什么启动报找不到 ffmpeg基本是第 1 步没装页面打不开先确认 8090 是否被占用。⚠️ 最常见的坑容器内 8090 是固定端口不能改只能改本地映射的 58090/xiaomusic_music、/xiaomusic_conf两个目录要先mkdir -p建好否则容器起不来。xiaomusic 部署后怎么玩语音点歌与歌单管理这节给两个最常用场景的具体操作步骤。场景一网上歌曲按需下载——适合曲库主要靠网上找的人web 控制台左侧小爱设备控制里确认设备在线直接说播放歌曲歌名xiaomusic 用 yt-dlp 现下现播下好的 mp3 落在 music 目录下次说同一首歌直接秒播下一首单曲循环随机播放等口令全部生效。隐藏玩法曲库里没有的歌也能直接说它会先下载再播听到顺耳的说一句加入收藏之后语音播放歌单收藏就能把收藏整批放出。图注播放列表页的全部/所有歌曲/收藏/下载四个标签页在线下载的歌曲和曲库歌曲都汇总在这里方便核对哪些歌已落到本地。场景二本地曲库接入——适合 NAS 已存了一批歌的人把本地音乐放进容器的 music 目录支持 mp3、flac、wav、ape、ogg、m4aweb播放列表页出现歌曲后双击某一行立刻在当前设备播放按文件夹整理后语音说播放歌单目录名即可整夹播放右上角下拉框可在多台音箱之间切换。隐藏玩法把在线电台写成 json 歌单配置仓库自带 m3u 转换工具能把电台 m3u 文件转成网络歌单小爱音箱直接收听。图注动图演示右上角下拉框切换音箱、下方按分类展开歌单的操作多台设备共用一台服务器时照这个切。用得放心吗数据在哪、能扩展什么这节回答部署到家用环境里安不安全。音乐数据在自己手里。曲库、下载缓存、播放记录都存在本机的 music 和 conf 目录不经过第三方云。代价是若把 58090 暴露到公网务必先在设置里开启密码登录README 明确警告过账号泄露风险。界面和插件可以换。项目内置 JS 插件机制见 plugins/ 目录社区做出了 pure、SoundSpace 等多套第三方主题和手机端配套 App默认后台觉得简陋时换主题不用改代码。迭代状态要心里有数。设置页底部有下载日志文件按钮反馈问题前带上日志定位快得多另外 README 顶部有作者停止维护的公告并推荐了社区接力项目长期部署前值得看一眼。回到开头那台只会说没找到的音箱部署完 xiaomusic来首 2000 年的老摇滚这句口令得到的回应会变成你 NAS 里那首歌的声音。本地曲库、在线现下、多台音箱切换全部收进同一个 web 后台里管理。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考