企业官网建设流程全解析

3 条命令搞定 xiaomusic：小爱音箱播放本地音乐指南

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

早上刷牙时你随口对客厅音箱说"播放周杰伦晴天"，一秒钟后音乐真的响了起来。这就是 xiaomusic 做的事：让小爱音箱播放你自己硬盘上的本地音乐，库里没有的歌它还能用 yt-dlp 联网下载后再播，全程语音控制，不花一分钱会员费。

它能干嘛：小爱音箱播放本地音乐的四个场景

原理一句话就能说清：你对小爱喊口令，xiaomusic 在后台收到指令，从你的音乐库找到对应歌曲推流给音箱。落到日常，就是这几件事：

• 上班路上在车里，对着音箱说"下一首"就切歌，不用掏手机开 App
• 周末家里来客人，说"随机播放"，本地音乐库自动打乱
• 睡觉前说"30分钟后关机"，音箱到点自己停
• 听到喜欢的歌说"加入收藏"，以后"播放歌单收藏"一次全放出来

和在线平台不一样，它播的是你自己硬盘上的文件，断网了照样能听，也不存在"这首歌下架了"的情况。设备侧支持 20 多款型号的小爱音箱、小米AI音箱、Xiaomi Sound 和触屏版音箱，一个服务可以同时管好几台。歌单想怎么组织就怎么组织，没有平台审核和会员限制。

最快跑通：xiaomusic Docker 一键部署

官方推荐用 Docker 跑一个容器，compose 文件就几行：

services: xiaomusic: image: hanxi/xiaomusic ports: - "58090:8090" volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

① 两个目录都在宿主机上，music放音乐、conf放配置文件，建议分开挂，不存在就先mkdir -p②docker compose up -d启动后，浏览器打开http://服务器IP:58090③ 网页设置页里填小米账号和密码保存，设备列表就能拉出来了 ④ 把音乐文件放进 music 目录，网页点刷新，歌单出现 ⑤ 最后对小爱说"播放歌曲"，有声音就算跑通

现在不需要设环境变量了，账号、端口、歌单这些参数都在网页上改。端口号可以随便换，记住冒号左边是宿主机端口、右边是容器端口就行。镜像拉取慢的话，把image换成docker.hanxi.cc/hanxi/xiaomusic即可；不想用 Docker 也可以pip install -U xiaomusic后直接运行xiaomusic命令，效果一样。

核心功能怎么用：语音口令、本地曲库与在线搜索

语音口令自定义

"说什么话、触发什么动作"的对应关系全在key_word_dict这个字典里，默认已经配好"下一首""单曲循环""分钟后关机""加入收藏"等整套口令，开箱就能用。

想加自己的口令就添一条：key 是你喊的话，value 是动作名，比如加一条"换一首": "play_next"，保存后喊"换一首"就切歌。命令清单可以直接对着 config-example.json 抄，连"删除歌曲"这种危险口令都预留了开关。现成的动作不够用时，plugins/ 目录里还有 httpget、httppost 几种脚本插件可以照着扩展。

本地曲库管理

音乐目录按music_path_depth递归扫描，mp3、flac、wav、ape、ogg、m4a 六种格式都收。子目录会被当作独立歌单，说"播放歌单+目录名"就能只放那一个文件夹，比如把"助眠"和"运动"分开放，各喊各的。

两个开关建议打开：enable_file_watch让新放进来的音乐过一会儿自动生效，不用手动刷新；convert_to_mp3让系统统一转成 mp3 再播，老型号不支持无损格式也不怕。

网页端能搜索、播放、删除歌曲，右上角还能在多台设备之间切换，播放模式、音量都在这一屏搞定。

在线搜索与下载

本地库里没有的歌，说"播放歌曲+歌名"，xiaomusic 会自动搜索、下载成 mp3 再播放，下次直接放本地文件。search_prefix能换搜索源，disable_download能禁止下载、只播本地，适合不想让下载内容占磁盘的场景。想听电台的话，再配一个music_list_url网络歌单，别人的分享链接也能直接接进来放。

踩坑与调优：四个高频问题

• 网页打不开→ 58090 是宿主机端口，可能被占用或路由器没放行 → 把冒号前改成别的端口即可，容器内的 8090 不用动
• 设备列表拉不出来→ 音箱和服务器不在同一局域网，或账号密码没保存成功 → 连同一个 WiFi，到设置页重新填账号保存再刷新
• 个别歌曲不响→ 部分老型号不支持 flac、ape 等无损格式 → 设置里打开convert_to_mp3重新播放
• 口令喊了没反应→ 设备掉线或口令拼写对不上 → 先在网页点设备名试播，再逐条比对key_word_dict

都不是的话，去网页设置页底部下载日志文件自己看，发出去之前检查别带出账号密码。

写在最后

小米音箱自带的音乐功能一直很弱，xiaomusic 把它变成了完全由你掌控的本地音乐播放器。源码与文档克隆仓库后从 README.md 开始看：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic

要放到公网访问的话，记得开启网页登录密码。

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