小爱音箱想听自己的歌xiaomusic 用 Docker 快速搭建指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic家里的小爱音箱默认只能放平台上的歌想让 NAS 里的无损曲库、自己下载好的整首歌一起出声官方渠道基本做不到。xiaomusic 是个开源项目干的事很直接把小爱音箱接到你自己的音乐上用 yt-dlp 下载网络歌曲再用语音口令控制播放。它跑在 NAS 或一台常开的小服务器上全程免费下面是从零到出声的路子。装完能做什么先看 3 个日常场景起床唤醒音乐每天固定时间自动放歌、到点自动关机不用人喊。语音点歌直接说播放歌曲 周杰伦 晴天它先去下载再播下一首、随机、单曲循环都能用嘴控制。全家共享曲库把 NAS 上整理好的文件夹整个挂上去多台音箱共用同一份歌谁想听哪首都行。下图是网页控制台的主界面左侧管账号和设备中间是歌曲列表右上角能切换要控制哪台音箱。先用 Docker 把服务跑起来准备三样东西就够一个 Docker 环境、一台小爱音箱、保证音箱和服务器在同一个局域网另外你手里要有一个小米账号后面绑设备用。部署主推 Docker Compose一条命令拉镜像、两个目录挂进去就行图省事也可以用pip install -U xiaomusic在服务器里直接跑原理一样只是少了容器隔离。把下面这段存成docker-compose.yml两个volumes路径改成你自己机器上的真实目录services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf然后mkdir -p /xiaomusic_music /xiaomusic_conf先把目录建出来再docker-compose up -d启动。启动成功后浏览器访问http://你的IP:58090就能看到后台。两个目录分工很清楚别放反宿主机目录容器内目录放什么/xiaomusic_music/app/music你的音乐文件下载的歌也存这里/xiaomusic_conf/app/conf账号、设备号等配置数据第一次让它出声绑设备、放音乐配什么。第一次只需要三个东西小米账号、密码以及要控制那台音箱的设备号mi_did。音乐目录默认就指向/app/music不用额外动。在哪配。现在的版本都在网页上改不用再折腾环境变量了。进后台的设置页填账号密码保存系统就会自动发现局域网里的音箱从列表里选中你的那台把设备号抄下来即可。怎么确认成功。两个信号设备列表里出现了你的音箱在网页上点任意一首歌能出声。能响说明账号和设备号都对上了后面语音控制才有基础。把你要放的音乐丢进/xiaomusic_music对应目录mp3、flac、wav、ape、ogg、m4a 都能识别。下面是刷新后的歌曲列表支持按所有歌曲 / 收藏 / 下载分类右上角照样能切设备。装完之后的进阶玩法玩通了基础播放下面这三样最常用按需开就行。定时任务自动放歌、定时关机。在配置的crontab_json里填一个 JSON 数组每条是一个标准 cron 任务支持的类型包括播放、关机、设音量、刷列表、文字转语音等。举个最直接的例子工作日早上 8 点播一首歌[ { expression: 0 8 * * 1-5, name: play, did: 你的DID, arg1: 周杰伦晴天 } ]expression是标准 crontab 表达式周一是 1did就是设备列表里那串数字arg1是要播的歌名。具体每种任务类型和字段含义完整说明见 docs/issues/182.md调度逻辑实现在 xiaomusic/crontab.py。网络歌单直接拉别人分享的列表。不想自己整理就把一个分享的歌单链接填到music_list_url或把本地的歌单 JSON 路径填到music_list_json电台和歌曲都支持还配了 m3u 转 JSON 的工具。用法看 docs/issues/78.md。多台设备一个服务控制多台音箱。家里有不止一台的话设备号用英文逗号连起来填就行比如did1,did2一次登录、多台受控。常见问题自查跑起来后最常卡的地方按现象 → 原因 → 解决对号入座后台看不到设备列表。多半是登录失败日志里会有 Login Failed。先关本地代理再在米家 App 里退出重登一次仍不行就去 mi.com 官网走一遍登录验证绑定的账号密码也要再核对一遍。网页能放、语音没反应。语音口令默认是关的要去设置里打开获取对话记录那个开关第一次存了设备号之后重启一次容器再试。口令前缀默认是播放歌曲说播放音乐是认不出来的。歌放不出声。一般是格式不兼容个别型号不支持 flac。打开转换为 MP3和型号兼容模式两个开关即可转换逻辑在 xiaomusic/utils/music_utils.py。用一阵子设备又不见了。通常是拉取对话太频繁被限。不用时把语音口令开关随手关掉语音提示也可以换 Edge-TTS 音色来绕开自带的 TTS。更多报错和对应处理项目把高频问题都收在 docs/issues/99.md 的 FAQ 里遇到卡点先查那里最省事。收尾记住三件事就够了Docker 一段配置起服务、网页上填账号和设备号、音乐丢进挂载目录剩下的点歌、定时、多设备都是网页上勾选和填字段的事。项目已停止维护、转向社区接力遇到 bug 建议以 docs/issues/99.md 和 docs/ 文档为准。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 小爱音箱想听自己的歌？xiaomusic 用 Docker 快速搭建指南
小爱音箱想听自己的歌xiaomusic 用 Docker 快速搭建指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic家里的小爱音箱默认只能放平台上的歌想让 NAS 里的无损曲库、自己下载好的整首歌一起出声官方渠道基本做不到。xiaomusic 是个开源项目干的事很直接把小爱音箱接到你自己的音乐上用 yt-dlp 下载网络歌曲再用语音口令控制播放。它跑在 NAS 或一台常开的小服务器上全程免费下面是从零到出声的路子。装完能做什么先看 3 个日常场景起床唤醒音乐每天固定时间自动放歌、到点自动关机不用人喊。语音点歌直接说播放歌曲 周杰伦 晴天它先去下载再播下一首、随机、单曲循环都能用嘴控制。全家共享曲库把 NAS 上整理好的文件夹整个挂上去多台音箱共用同一份歌谁想听哪首都行。下图是网页控制台的主界面左侧管账号和设备中间是歌曲列表右上角能切换要控制哪台音箱。先用 Docker 把服务跑起来准备三样东西就够一个 Docker 环境、一台小爱音箱、保证音箱和服务器在同一个局域网另外你手里要有一个小米账号后面绑设备用。部署主推 Docker Compose一条命令拉镜像、两个目录挂进去就行图省事也可以用pip install -U xiaomusic在服务器里直接跑原理一样只是少了容器隔离。把下面这段存成docker-compose.yml两个volumes路径改成你自己机器上的真实目录services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf然后mkdir -p /xiaomusic_music /xiaomusic_conf先把目录建出来再docker-compose up -d启动。启动成功后浏览器访问http://你的IP:58090就能看到后台。两个目录分工很清楚别放反宿主机目录容器内目录放什么/xiaomusic_music/app/music你的音乐文件下载的歌也存这里/xiaomusic_conf/app/conf账号、设备号等配置数据第一次让它出声绑设备、放音乐配什么。第一次只需要三个东西小米账号、密码以及要控制那台音箱的设备号mi_did。音乐目录默认就指向/app/music不用额外动。在哪配。现在的版本都在网页上改不用再折腾环境变量了。进后台的设置页填账号密码保存系统就会自动发现局域网里的音箱从列表里选中你的那台把设备号抄下来即可。怎么确认成功。两个信号设备列表里出现了你的音箱在网页上点任意一首歌能出声。能响说明账号和设备号都对上了后面语音控制才有基础。把你要放的音乐丢进/xiaomusic_music对应目录mp3、flac、wav、ape、ogg、m4a 都能识别。下面是刷新后的歌曲列表支持按所有歌曲 / 收藏 / 下载分类右上角照样能切设备。装完之后的进阶玩法玩通了基础播放下面这三样最常用按需开就行。定时任务自动放歌、定时关机。在配置的crontab_json里填一个 JSON 数组每条是一个标准 cron 任务支持的类型包括播放、关机、设音量、刷列表、文字转语音等。举个最直接的例子工作日早上 8 点播一首歌[ { expression: 0 8 * * 1-5, name: play, did: 你的DID, arg1: 周杰伦晴天 } ]expression是标准 crontab 表达式周一是 1did就是设备列表里那串数字arg1是要播的歌名。具体每种任务类型和字段含义完整说明见 docs/issues/182.md调度逻辑实现在 xiaomusic/crontab.py。网络歌单直接拉别人分享的列表。不想自己整理就把一个分享的歌单链接填到music_list_url或把本地的歌单 JSON 路径填到music_list_json电台和歌曲都支持还配了 m3u 转 JSON 的工具。用法看 docs/issues/78.md。多台设备一个服务控制多台音箱。家里有不止一台的话设备号用英文逗号连起来填就行比如did1,did2一次登录、多台受控。常见问题自查跑起来后最常卡的地方按现象 → 原因 → 解决对号入座后台看不到设备列表。多半是登录失败日志里会有 Login Failed。先关本地代理再在米家 App 里退出重登一次仍不行就去 mi.com 官网走一遍登录验证绑定的账号密码也要再核对一遍。网页能放、语音没反应。语音口令默认是关的要去设置里打开获取对话记录那个开关第一次存了设备号之后重启一次容器再试。口令前缀默认是播放歌曲说播放音乐是认不出来的。歌放不出声。一般是格式不兼容个别型号不支持 flac。打开转换为 MP3和型号兼容模式两个开关即可转换逻辑在 xiaomusic/utils/music_utils.py。用一阵子设备又不见了。通常是拉取对话太频繁被限。不用时把语音口令开关随手关掉语音提示也可以换 Edge-TTS 音色来绕开自带的 TTS。更多报错和对应处理项目把高频问题都收在 docs/issues/99.md 的 FAQ 里遇到卡点先查那里最省事。收尾记住三件事就够了Docker 一段配置起服务、网页上填账号和设备号、音乐丢进挂载目录剩下的点歌、定时、多设备都是网页上勾选和填字段的事。项目已停止维护、转向社区接力遇到 bug 建议以 docs/issues/99.md 和 docs/ 文档为准。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考