企业官网建设流程全解析

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 手动安装（适合开发者）

1. 准备 Python 环境，确认系统装了 ffmpeg（音频转换依赖它，which ffmpeg查不到就先装）。
2. 执行pip install -U xiaomusic装好程序。
3. 参考仓库里的 config-example.json 写一份config.json。
4. 运行xiaomusic --config config.json启动，默认监听 8090 端口。
5. 浏览器访问http://localhost:8090验证页面，/docs可看接口文档。

卡住了先查什么：启动报找不到 ffmpeg，基本是第 1 步没装；页面打不开，先确认 8090 是否被占用。

⚠️ 最常见的坑：容器内 8090 是固定端口不能改，只能改本地映射的 58090；/xiaomusic_music、/xiaomusic_conf两个目录要先mkdir -p建好，否则容器起不来。

xiaomusic 部署后怎么玩：语音点歌与歌单管理

这节给两个最常用场景的具体操作步骤。

场景一：网上歌曲按需下载——适合曲库主要靠网上找的人

1. web 控制台左侧"小爱设备控制"里确认设备在线；
2. 直接说"播放歌曲+歌名"，xiaomusic 用 yt-dlp 现下现播；
3. 下好的 mp3 落在 music 目录，下次说同一首歌直接秒播；
4. "下一首""单曲循环""随机播放"等口令全部生效。

隐藏玩法：曲库里没有的歌也能直接说，它会先下载再播；听到顺耳的说一句"加入收藏"，之后语音"播放歌单收藏"就能把收藏整批放出。

图注：播放列表页的"全部/所有歌曲/收藏/下载"四个标签页，在线下载的歌曲和曲库歌曲都汇总在这里，方便核对哪些歌已落到本地。

场景二：本地曲库接入——适合 NAS 已存了一批歌的人

1. 把本地音乐放进容器的 music 目录，支持 mp3、flac、wav、ape、ogg、m4a；
2. web"播放列表"页出现歌曲后，双击某一行立刻在当前设备播放；
3. 按文件夹整理后，语音说"播放歌单+目录名"即可整夹播放；
4. 右上角下拉框可在多台音箱之间切换。

隐藏玩法：把在线电台写成 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