企业官网建设流程全解析

语音点播任意歌曲：XiaoMusic 音乐播放快速上手

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

XiaoMusic 是一个开源音乐播放项目，帮小爱音箱用户解决"想听的歌没版权"的问题：它用 yt-dlp 把音乐下载成本地 mp3，再交给小爱音箱播放，语音点播照常生效。

🚀 跑起来：容器加网页，三步接通音箱

1. 起容器。把下面的配置存成 docker-compose.yml，执行docker compose up -d。国内拉镜像慢的话，把 image 换成docker.hanxi.cc/hanxi/xiaomusic：

# 音乐文件挂 /app/music，配置挂 /app/conf，两个目录建议分开 services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

2. 打开后台。浏览器访问http://NAS_IP:58090，58090 是你映射的本地端口。
3. 填账号选设备。在设置页输入小米账号密码并保存，页面会拉出设备列表，勾选要控制的小爱音箱即可。

启动时如果报"找不到 /xiaomusic_music"，说明宿主机没有这个目录，先执行mkdir -p /xiaomusic_{music,conf}建好再启动。

常用型号都在支持列表里：

🎧 拿它做什么：三条最常用路径

点播一首歌。你对小爱说"播放歌曲周杰伦晴天"，XiaoMusic 拦截这条口令，用 yt-dlp 搜歌并把 mp3 下载到音乐目录，然后让音箱播放。这首歌曲从此留在本地歌单里，下次再点直接播，不用重复下载。

播本地和歌单。把你已有的 mp3、flac 文件按文件夹分好，放进 music 挂载目录，说"播放歌单+目录名"，它就扫描对应文件夹的顺序播放，全程离线。听中意的可以说"加入收藏"，攒出一个收藏歌单，随时"播放歌单收藏"。

隐藏玩法：播有声内容。说"播放小猪佩奇的故事"，它会先下载小猪佩奇的故事音频再播放，音箱顺便变成了有声书播放器。

🎨 按自己的喜好改

• 换主题：xiaomusic/static/目录里自带 default、pure、tailwind、xplayer、soundSpace 几套 Web 主题，后台页面上选一个即可，不折腾用默认主题就够。
• 改口令："下一首""随机播放"这些命令都来自 config-example.json 里的key_word_dict，可以加自己的口令；plugins/里有 httpget、httppost 等 JS 插件示例，能让口令去触发 HTTP 请求。
• 网络歌单：后台支持配置 json 格式网络歌单，可以收电台，网页端还带了 m3u 转 json 的工具。

🛠 卡住了？三个最常见的坑

• Web 页面拉不出设备列表→ 多半是没填小米账号或填错了 → 到设置页输入小米账号密码点保存，保存成功后才会获取设备列表。
• 点播后没声音、报错格式→ 多半是设备不支持 flac，L05B、L05C、LX06、L16A 这几个型号已知不支持 → 在设置里打开【转换为MP3】和【型号兼容模式】。
• 说口令没反应→ 多半是音箱和服务器不在同一局域网 → 确认两者在同一 WiFi 下；如果歌下不下来，检查容器网络或去设置页配置代理。

📍 接下来去哪

XiaoMusic 把小爱音箱从"只能播平台版权曲库"变成"本地歌单 + 按需下载"的混合音乐播放中心。

# 源码仓库，clone 下来可以读文档和改配置 git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic

• 文档和问题集合：docs/issues/ 目录，其中 99.md 是 FAQ，新手先查这里。
• 配置参照：config-example.json 是完整配置项示例，pip 安装方式的用户直接照着填。
• 社区入口：官方 QQ 群、微信群、GitHub Issues，入口写在 README.md 的"社区与支持"一节。

提醒一下：README 已声明本项目停止维护，作者推荐社区接力项目 songloft，上手前可以留意一下。项目仅供个人学习和研究使用，下载的音乐请限于自己收听，注意版权边界，不要二次分发。

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