企业官网建设流程全解析

XiaoMusic完整教程：15分钟让小爱音箱接入全网音乐库

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

你对着桌上的音箱说一句"播放歌曲 学之前"，它很快就唱了出来——不是平台曲库，而是你自己硬盘里的歌。这就是部署 XiaoMusic 后的效果：绑定小米账号，音箱按你的语音指令播放能搜到的歌曲。项目用 yt-dlp 下载音乐，让小爱音箱播放本地音乐。

🎧 XiaoMusic使用场景：日常里的四个时刻

你在厨房洗碗，突然想听首歌。走到客厅喊一声"播放歌曲 学之前"，很快旋律就出来了。这首歌不来自音箱内置平台，而是 XiaoMusic 已下载到硬盘里的文件，第二次听就不用再等。

睡前孩子要听故事，你说"播放歌曲 三只小猪"，它会先在线搜索下载，再直接播出来。这种"先下后播"的隐藏玩法，对儿童故事、评书同样有效。

想听很多年的冷门老歌、老电台节目，也能靠在线搜歌拉进自己的库，保存下来随时听，不用反复担心下架。

家里有好几台音箱，客厅一台卧室一台，你可以在管理页切换设备，决定让哪台播放，全家各有各的歌单。这些效果背后是同一套机制，下面一分钟看完它怎么工作。

原理速览：拦截、下载、播放三步走

1. 拦截语音指令

XiaoMusic 用你的小米账号登录，持续轮询音箱的"对话记录"——也就是音箱听到的文字。发现"播放歌曲"这类词时，它接管后续动作。

2. 用 yt-dlp 下载音乐

yt-dlp 是一个从网上下载音视频的工具。XiaoMusic 拿歌名在线搜索，把音频存成本地 mp3，默认搜索源是 B 站，逻辑见 xiaomusic/online_music.py。

3. 存入本地音乐库

下载的歌会被索引进本地音乐库，之后再点同一首直接读硬盘。支持 mp3、flac、wav、ape、ogg、m4a，还能按目录分分类。

XiaoMusic部署教程：Docker一条命令启动

第一步：在宿主机准备两个目录，一个放歌、一个放配置。

第二步：启动容器：

docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

参数说明：

• -p 58090:8090：容器端口映射到宿主机，访问 http://NAS_IP:58090 进入管理页
• -v /xiaomusic_music:/app/music：宿主机上的音乐目录，可换成任意已存在路径
• -v /xiaomusic_conf:/app/conf：宿主机上的配置目录

第三步：打开网页，填入小米账号和密码保存，页面就会列出你账号下的设备，其余参数都能之后在页面调整。

不想用 Docker 的话，也可以pip install -U xiaomusic后运行xiaomusic --config config.json，参考仓库里的 config-example.json 编写配置。

进阶玩法：语音场景与网络歌单配置

自定义语音场景

在配置的 user_key_word_dict 里加映射，把自创短语绑定到动作：

"user_key_word_dict": { "晚安": "stop", "测试插件": "exec#code1(\"hello\")" }

保存后说"晚安"音箱直接停止，exec# 还能调用 plugins/ 里你自己写的 Python 脚本。

网络歌单

把 json 歌单文件的地址填进 music_list_json，电台和歌曲都支持；已有 m3u 电台文件的话，用项目自带的转换工具转成 json 即可。

"music_list_json": "/app/conf/music_list.json"

保存后说"播放歌单"，音箱就按列表顺序播。

多设备协同

管理页右上角的设备下拉框可以切换目标音箱，配置里的 group_list 还支持分组，不同房间各放各的单。

⚠️ 注意事项与FAQ

项目已实测 L06A、L05B、L16A、LX01 等十余款音箱型号。个别型号（如 L05B、L05C、LX06、L16A）不支持 flac，格式播不了时打开【转换为MP3】和【型号兼容模式】即可。

服务如果暴露公网，务必开启密码登录并设置复杂密码，也建议别用绑定了摄像头的小米账号。另外作者已公告停止维护，推荐社区接力项目 songloft，现有功能仍可正常使用。

问：部署后设备列表是空的？ 答：检查账号密码是否正确，保存后稍等片刻，刷新页面再获取设备。

问：第一次播歌为什么要等一会儿？ 答：首次需要在线搜索并下载，第二次起直接从本地音乐库播放。

问：出问题怎么看日志？ 答：在 Web 设置页底部点【下载日志文件】，确认无敏感信息后提 issue 附上。

XiaoMusic 让小爱音箱拥有一个你说了算的本地音乐库。家里有音箱的话，用一条 Docker 命令就能上手，遇到问题可以提 issue 交流。

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic