尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
XiaoMusic Docker 部署教程:10 分钟用 NAS 给小爱音箱免费播歌
XiaoMusic Docker 部署教程10 分钟用 NAS 给小爱音箱免费播歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一款面向小爱音箱的开源音乐播放工具它拦截音箱的播放歌曲语音指令用 yt-dlp 从在线平台搜索并下载到本地曲库再让音箱直接从 NAS 上读取播放。换句话说不用开通音乐会员小爱音箱也能免费播歌。只要手边有一台能长期运行 Docker 的机器和一个小爱音箱Docker 部署 XiaoMusic 全程大约 10 分钟之后日常使用只靠嘴。动手前备齐三样东西机器能长期跑 Docker 的设备即可家用服务器、NAS 或一台闲置小主机都行小爱音箱官方已测试支持的型号包括 L06A、L07A、S12/S12A、LX05、L15A、L16AXiaomi Sound、L17AXiaomi Sound Pro等不在清单里的型号通常也能用直接试即可完整型号对照表见仓库 README.md小米账号工具靠小米账号登录来连接音箱配置时要填账号密码。顺手把两个目录定下来一个放下载的音乐一个放配置文件。仓库明确建议两者分开挂载混在一起以后迁移和备份都麻烦。 Docker 部署一条命令拉起服务在机器终端执行下面这条命令容器就会开始下载镜像并启动docker run -p 58090:8090 \ -v /home/你的用户名/music:/app/music \ -v /home/你的用户名/xiaomusic-conf:/app/conf \ hanxi/xiaomusic说明58090是宿主机对外暴露的端口可按自己环境改8090是容器内的固定服务端口不要动。两个宿主机目录若不存在先mkdir -p建好再启动否则会报路径找不到。容器起来后浏览器访问http://服务器IP:58090就是 Web 管理页。不想用 Docker 也可以走源码方式一行装好并直接启动pip install -U xiaomusic xiaomusic它默认同样监听 8090 端口。整个链路其实不复杂你喊播放歌曲时XiaoMusic 会接管这条指令曲库里有就直接播没有就先用 yt-dlp 下好再播。所以大多数歌只在第一次点播时联网之后全是本地读取几乎没有等待。首次配置三步绑定音箱第一次打开页面只需填带*的必填项输入小米账号与密码并保存——这一步做完才能拉到设备列表确认音乐存储路径与 Docker 挂载目录一致服务端口保持默认 8090其余选项用不到就全部默认。页面背后对应的就是 conf 目录里的配置文件仓库里提供了完整样例 config-example.json需要手动改参数时照它对照即可。配置完成后网页右上角能看到设备即代表绑定成功家里有多台音箱时右上角可以切换当前操作的那一台。 日常怎么和它说话部署完之后基本不用碰页面全部语音完成。常用口令播放歌曲播本地曲库播放歌曲歌名如播放歌曲周杰伦晴天指定播某首本地没有会自动先下载上一首 / 下一首切歌关机 / 停止播放停止单曲循环 / 全部循环 / 随机播放切换播放模式播放歌单目录名播对应子目录的歌单播放歌单收藏播收藏列表加入收藏 / 取消收藏管理当前歌曲。还有个附赠玩法这条指令对非音乐内容也生效。说播放歌曲小猪佩奇的故事它会先把对应音频下载下来再播有小孩的家庭可以直接当故事机用。本地库之外还支持网络歌单歌单是 JSON 格式电台和歌曲都支持别人分享的歌单链接可以直接拿来用手里有 M3U 电台文件的网页内置了转换工具可以转成 JSON 网络歌单。自定义语音口令字典XiaoMusic 的全部口令都由指令字典驱动。内置指令集是key_word_dict你要加新口令只需在user_key_word_dict里补条目不用碰内置集合指令值支持exec#code1(...)调用自定义脚本user_key_word_dict: { 晨间唤醒: exec#code1(\播放晨间音乐\), 睡前安眠: exec#code1(\播放白噪音\) }示例脚本在 plugins/ 目录照着code1.py的结构就能写自己的逻辑一句话口令可以触发任意你想编排的播放动作或脚本流程。部署前核对型号、音频格式与安全三个容易踩的点音频格式本地库识别 mp3、flac、wav、ape、ogg、m4a下载的歌曲统一是 mp3。部分型号如 L05B、L05C、LX06、L16A不支持 flac格式播不了时在设置里打开转换为MP3和型号兼容模式即可账号安全要公网访问网页就务必开启密码登录并设复杂密码不要在公共 WiFi 环境下使用避免小米账号密码泄露也不建议把绑音箱的小米账号同时用于摄像头等设备凭据泄露时影响面会更大排查问题连不上音箱先核对账号密码再看网络网页上可以直接下载日志文件定位原因更多资料先翻仓库 docs/。另外提前知道一件事仓库已标注本项目停止维护作者推荐社区接力项目songloft打算长期部署的话留意一下这个状态。家里有闲置 NAS 和小爱音箱的话把上面那条 Docker 命令跑一遍让小爱同学先给你播上第一首本地下载的歌。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

ROS2机器人开发实战路线图:从DDS通信到真实部署

ROS2机器人开发实战路线图:从DDS通信到真实部署

1. 这不是“教程搬运”,而是一份ROS2机器人开发的实战路线图你点开这个标题,大概率是刚接触机器人开发,手头可能连一台能跑Linux的旧笔记本都没有,或者刚装完Ubuntu却卡在sudo apt update报错那一步;也可能是学过ROS1&…

📅 2026/10/4 11:18:01
面试高频数学题背后的结构化思维本质

面试高频数学题背后的结构化思维本质

1. 这些题不是考数学,是考你“怎么想问题”“截木棍”“圆上取点”“赛马”“红蓝墨水”“毒药测试”“坐错座位”——如果你在准备技术岗、产品岗、咨询岗甚至部分金融岗的面试,大概率已经见过这组题。它们从不标榜自己是“奥数题”,却总在简…

📅 2026/10/4 11:18:01
OpenRig:基于Node.js+tmux+Codex+YAML的本地大模型开发环境规范

OpenRig:基于Node.js+tmux+Codex+YAML的本地大模型开发环境规范

1. OpenRig 是什么:一个被误读的开源项目名称与真实技术图谱OpenRig 这个词在当前中文技术社区里,正经历一场典型的“语义漂移”——它既不是某个广为人知的成熟开源项目(如 OpenCV、OpenSSH),也不是官方发布的标准化工…

📅 2026/10/4 11:18:01
MORE NEWS

更多资讯

📰

LangChain4j Java AI 应用开发实战(二十四):人机协同与非 AI Agent —— 混合执行系统

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📰

MR25H40CDF MRAM与STM32L496ZG工业存储方案实战

1. 为什么MR25H40CDF在工业场景里值得被单独拿出来说如果你做过工业数据采集、PLC控制器或者电力监测终端,大概率遇到过同一个尴尬:系统跑得好好的,一断电,关键的校准参数、累计电量、故障记录全没了。用EEPROM吧,写入…

📰

MR25H40CDF MRAM与PIC18F86J15的SPI存储方案及掉电保护

1. 项目缘起与方案选型:为什么是 MR25H40CDF 加 PIC18F86J15工业现场的数据记录仪、PLC 扩展模块、智能仪表这类设备,对“存数据”这件事的要求跟消费电子完全不是一个量级。消费电子可以接受掉电丢最后几秒数据,工业设备不行——一条产线参数…

📰

工业嵌入式数据存储方案:MRAM与PIC32的SPI实战解析

做工业嵌入式项目,最怕的不是代码跑飞,而是数据丢。前阵子做一台环境监测主机的状态记录器,要求在设备反复断电、环境温度贴近 70℃ 的条件下,把运行日志、告警事件和标定参数可靠保存并随时读出。最后选定 Everspin 的 MR25H40CD…

📰

Java Web毕业选题系统课设源码详解:JSP+Servlet+MySQL实现

简介:面向高校计算机及相关专业学生的Java Web毕业设计选题系统完整源码包,覆盖管理员、教师、学生三类角色:管理员负责系统维护,并可增删管理系主任信息;教师可录入毕业设计题目,并对学生的选题进行审核&a…

📰

近场动力学模拟二维疲劳裂纹扩展:从理论到代码实践

近场动力学这几年在断裂模拟领域的热度一直不低,尤其是做疲劳裂纹扩展的人,多多少少都动过用它的念头。传统的有限元处理裂纹,要么靠网格重划,要么靠扩展有限元里的富集函数去“迁就”裂纹路径,一旦遇到多裂纹交汇、分…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬