如何用xiaomusic让小爱音箱10分钟播放本地音乐新手部署指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你对小爱说播放周杰伦它只会放自家平台里有的歌。xiaomusic 是一个开源项目让小爱音箱直接播放你 NAS 里的本地音乐没收录的歌还能用 yt-dlp 在线下载后播放。读完本文你能用一条 Docker 命令部署它绑好音箱语音点出一首歌。对比本地音乐库赢在哪维度平台曲库方案手动配捷径/TTSxiaomusic音乐来源平台曲库会员限定自己放几首NAS 目录全部文件mp3/flac/ape/wav/ogg/m4a补新歌无曲库固定手动下载再放口头说歌名yt-dlp 自动下载入库设备支持单台音箱依赖机型与折腾程度已测试 20 款小爱音箱型号上手成本无多应用、多配置建两个目录 一份 compose 文件十分钟跑通第一首歌前提一台能跑 Docker 的机器NAS 最佳音箱和它在同一局域网。mkdir -p /xiaomusic_music /xiaomusic_conf写好docker-compose.yml容器内路径/app/music和/app/conf不要改宿主机目录可以换成你自己的services: xiaomusic: image: hanxi/xiaomusic # 拉取慢可改 docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 # 58090 可换8090 固定 volumes: - /xiaomusic_music:/app/music # 音乐目录 - /xiaomusic_conf:/app/conf # 配置目录docker compose up -d浏览器里做三件事打开http://NAS_IP:58090在账号设置填入小米账号密码并保存在播放列表里等设备列表出现选中你要控制的小爱音箱往音乐目录丢一首 mp3双击歌曲音箱出声✅ 音箱里传出音乐就算跑通了。后面所有功能都建立在这三件事之上。跑通之后能干什么绑好音箱网页直接放歌解决的问题绑定成功但想眼见为实或者想临时换一台音箱放。怎么配全程 Web 操作不用写代码。账号设置填好账号密码后设备列表自动出现右上角切换当前播放设备播放列表按 全部/所有歌曲/收藏/下载 四个分类浏览。配完效果双击任意歌曲立刻在所选音箱播放底部控制条可以切单曲循环、全部循环、上一首下一首还能拖进度条和调音量。整理本地音乐库解决的问题几千首本地歌想按目录翻、想收藏常听的。怎么配把音乐文件放进挂载的 music 目录即可mp3、flac、ape、wav、ogg、m4a 都能识别目录支持多层嵌套exclude_dirs字段可以排除不想扫的文件夹如群晖的eaDir。配完效果播放列表里出现歌手 - 歌名格式的完整曲库语音说加入收藏就能把当前歌存进收藏分类。说个歌名就自动下载解决的问题库里没有的歌不想去网页搜索再下载。怎么配默认已开启无需额外配置。config-example.json 里key_word_dict已把播放歌曲映射到播放指令search_prefix默认bilisearch:决定联网搜索的来源。配完效果对小爱说播放歌曲小猪佩奇的故事它会先用 yt-dlp 下载并保存到音乐目录然后直接播放。同一首歌第二次点播就不再重复下载。电台和歌单进播放列表解决的问题本地曲库覆盖不全想长期听电台或别人分享的播单。怎么配设置页的网络歌单输入框填 JSON 歌单地址或改 config.json{ music_list_url: // 填入你要用的 JSON 歌单地址 }配完效果歌单里的电台和歌曲可以直接说播放歌单 名称点播。手上有 m3u 电台文件的话用 Web 内置的转换工具转成 JSON 即可用法见 docs/issues/78.md 和 docs/issues/88.md。定时唤醒和定时关机解决的问题每天早上放唤醒音乐、深夜自动停播不想天天口头吩咐。怎么配crontab_json字段填 crontab 格式的任务数组[ { expression: 0 8 * * 0-4, // 工作日早8点 name: play, // 还支持 stop、set_volume 等 did: 123456789, arg1: 周杰伦晴天 } ]配完效果音箱每天 8 点自己开播再加一条stop任务就能深夜自动静音。字段说明见 docs/issues/182.md。坏了怎么救现象可能原因处理办法设备列表为空账号未保存或音箱不在同一网络账号设置填小米账号密码并保存确认音箱与 NAS 同局域网选歌后不出声、只有提示音格式或型号不兼容L05B/LX06 等不支持 flac设置里开启转换为MP3和型号兼容模式网页看不到本地歌曲music 目录挂载错检查 compose 的 volumes 映射确认宿主机目录里有文件音箱拉不到播放链接hostname 默认是 local 域名把NAS的IP或域名改成 NAS 的局域网 IP拉取镜像极慢或超时官方源不可达image 字段改成docker.hanxi.cc/hanxi/xiaomusic还查不到的问题先看 FAQ问题集合大多数情况都有现成答案。进阶玩法清单改默认 8090 端口docs/issues/19.md全部设置项逐项说明转 MP3、文件监听、代理等docs/issues/333.md自定义语音口令一句口令绑定你自己的 Python 插件示例代码在 plugins/用法见 docs/issues/105.md用 config.json 文件启动、替代网页配置docs/issues/94.md批量下载歌曲、上传 yt-dlp cookiesdocs/issues/212.md、docs/issues/210.md文档总索引docs/issues/211.md开始听歌xiaomusic 的本质本地曲库打底、在线下载兜底、语音当入口省掉的是会员费付出的只是一个 Docker 镜像。文档入口看 docs/issues/211.md提问前到仓库 Issues 搜一遍已有讨论。现在就可以docker compose up -d开始了。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考