企业官网建设流程全解析

小爱音箱音乐播放一次搞定：本地音乐上音箱的3种路径

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

你是不是也试过让小爱音箱播放本地音乐，结果只换来一句"抱歉，没有找到"？xiaomusic 就是来解决这件事的：把本地音乐库指给它，网络歌曲报个歌名它自己下载再播。适合手里有小爱音箱、有一台 NAS 或者愿意跑一个 Docker 容器的你。

🚀 五分钟跑起小爱音箱音乐播放

不用装 Python 环境，不用手动配依赖，下面三种方式从最省事开始，挑一个就行。

xiaomusic Docker 部署（最省事）

1. 在机器上建两个目录：一个存音乐，一个存配置。
2. 跑这条命令：

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

3. 浏览器打开http://你的IP:58090，进设置页。

Docker Compose（长期挂着稳）

1. 写个 compose 文件，核心就这几行：

services: xiaomusic: image: hanxi/xiaomusic restart: always ports: ["58090:8090"]

2. 把音乐和配置两个目录同样挂到/app/music和/app/conf。
3. docker compose up -d收工，restart: always保证 NAS 重启后服务自己回来。

pip 安装（想动源码的看这里）

1. 准备 Python 3.8+，一条命令装上。
2. 用配置文件启动，缺什么参数看仓库里的config-example.json：

pip install -U xiaomusic xiaomusic --config config.json

3. 端口同样是 8090，打开网页进设置页即可。

三种方式最后一步都一样：在设置页填小米账号密码并保存，设备列表里能看到你的小爱音箱，就算成功了。

🎵 它到底能帮你做什么

原来的小爱音箱语音口令完全不受影响，日常还能照常使唤它，音乐这边则多了一批实用能力。

开口就能播。你对着音箱说"播放周杰伦的晴天"，它直接放，不用掏手机切歌。播到一半"下一首""单曲循环""随机播放"也全听得懂。

本地没有的歌自动帮你下。报个歌名，本地库里没有就用 yt-dlp 找到、下载、再播放，整个过程你不用管。下次再点同一首，它已经在音乐库里，秒出。

歌单也认语音。你可以按文件夹把音乐分门别类，一句"播放歌单儿童"就切过去。哪首听得爽，补一句"加入收藏"，它就归进收藏列表，以后说"播放歌单收藏"接着听。

📻 真实用法

如果你是想给孩子放故事，试试说"播放歌曲小猪佩奇的故事"，它会自动下载再播放，不用你守在手机旁边切歌，卧室里特别好用。

如果你是想把 NAS 上攒的无损音频用起来，把音乐目录指向你的曲库就行，在家喊歌名即可。个别型号播 FLAC 需要转换，在设置页把转换为 MP3打开就好。

🩹 卡住了？先看这里

• 音箱没反应、但网页看起来正常 → 确认音箱和跑服务的主机在同一局域网，再核对配置里的设备信息。
• 播放有状态没声音 → 先调音箱音量，FLAC 文件再检查是否开了 MP3 转换。
• 网络歌曲下不动 → 先看网络连接，再考虑换下载源，别上来就怀疑账号。

下一步

以后想听歌，不用再打开手机挑平台了。把那条 docker 命令跑起来，等到音箱里传出你熟的那段前奏，就成了。

xiaomusic 已停止维护，需要持续更新与支持的话，建议迁移到社区接力项目 songloft。

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