保姆级教程如何用6步完成XiaoMusic部署让小爱音箱播放你的私人音乐库【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic是一款能让小爱音箱播放本地和在线音乐的开源工具音乐下载交给yt-dlp完成。你只需要对小爱同学说一句播放周杰伦的晴天音箱就会立刻响起你收藏的高品质音乐。这篇文章用6个步骤带你完成全部部署全程不涉及任何专业术语照着做就行。这就是部署成功后的管理界面左侧控制音箱中间管理歌曲一目了然一、6件事做完就成功我把整个部署过程拆成了6件小事做完第6件你就可以对着小爱音箱点歌了✅ 第1件准备两个抽屉目录和一份部署清单compose文件✅ 第2件把XiaoMusic放进抽屉启动容器✅ 第3件在浏览器里打开控制台✅ 第4件让工具认领你的小爱音箱绑定小米账号✅ 第5件往抽屉里塞进你的音乐✅ 第6件验收——说出第一句点歌口令原理小卡片XiaoMusic到底在忙什么它就像一个翻译官小爱音箱只会说小米话你的音乐库只会文件话。XiaoMusic负责把你说的话翻译成音箱能执行的命令播放、暂停、切歌再把音乐文件喂给音箱播放。整个过程中yt-dlp负责在你想听的歌不存在时帮你从网上把它下载下来。二、第1件准备两个抽屉和一份部署清单容器技术Docker就像给你准备了一个独立的小房间所有软件依赖都装在里面不会弄乱你的电脑。我们要做的是建两个目录一个放音乐一个放配置mkdir -p /xiaomusic_music /xiaomusic_conf这句话的意思是在电脑上创建两个文件夹。/xiaomusic_music专门放歌/xiaomusic_conf专门放账号密码等设置。两个分开互不打扰。写一份部署清单新建一个名为docker-compose.yml的文件内容如下services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf如果你在国内网络下载镜像比较慢可以把第一行的镜像地址换成docker.hanxi.cc/hanxi/xiaomusic速度会快很多。人话解释58090:8090是说浏览器访问58090端口容器内部用8090端口后面访问网页时你会用到58090/xiaomusic_music:/app/music是把你的音乐文件夹和容器里的音乐文件夹打通你往左边放歌容器就能在右边看到。三、第2件启动你的XiaoMusic清单写好后回到命令行一条命令启动docker compose up -d人话告诉Docker按这份清单把XiaoMusic跑起来。-d表示在后台运行不会占着你的终端窗口。启动后看一眼状态确认它在正常运行docker ps | grep xiaomusic如果看到了xiaomusic这一行说明容器已经跑起来了。四、第3件在浏览器里打开控制台打开你常用的浏览器输入http://你的设备IP:58090你的设备IP指的是运行Docker的那台电脑/NAS的局域网地址比如192.168.1.100那么地址就是http://192.168.1.100:58090。避坑提示如果你打不开网页先检查58090端口是不是被其他程序占用了另外别忘了看防火墙很多新手的网页打不开都是被防火墙拦下的。打开后你会看到一个清爽的音乐管理界面右边是歌曲列表左边是功能菜单这就是你未来控制音箱的总指挥台。五、第4件让工具认领你的小爱音箱这是整个部署中唯一需要动脑子的一步但也只是填两个框、点几下鼠标在界面左侧找到账号设置输入你的小米账号和密码点保存等待几秒它会自动获取你家的小米设备列表刷新页面在设备列表里勾选你要控制的那台小爱音箱再次保存完成绑定安全提醒账号密码相当于你家的门钥匙请只在自家WiFi环境下配置别在公共网络里操作。另外强烈建议不要把这个小米账号绑定摄像头等隐私设备万一泄露后果严重。绑定成功后左侧的小爱设备控制菜单里就能看到你的音箱了播放列表下方也可以随时切换音箱设备。原理小卡片为什么要绑定账号小爱音箱只听小米官方的话。XiaoMusic拿着你的小米账号以官方身份去和音箱对话音箱才愿意执行命令。这就是为什么第一步必须绑定账号——没有这层身份音箱会把你当成陌生人。六、第5件往抽屉里塞进你的音乐把音乐文件直接放进/xiaomusic_music文件夹即可。XiaoMusic会自动扫描这个目录支持下面这些格式格式说明MP3最常见的音频格式兼容性最好FLAC / WAV无损音质追求CD级体验APE / OGG / M4A小众格式也能播放避坑提示如果你家的音箱是老型号比如L05B、L05C可能不支持FLAC这类无损格式。遇到歌有但播不出来的情况去设置里打开【转换为MP3】让XiaoMusic先把歌转成音箱能听的格式再播放。放进音乐后在界面的歌曲列表里刷新一下就能看到你的歌单了。如果某个文件夹的歌很多XiaoMusic还会自动按文件夹把它变成一个歌单。七、第6件验收说出你的第一句点歌口令一切就绪现在走到你的小爱音箱前对它说播放歌曲周杰伦的晴天如果音箱响起了你熟悉的旋律恭喜你部署成功八、翻车现场三个最常见的坑我身边好几个朋友都是栽在这三处提前看一眼能帮你省下半小时症状原因自救办法网页打不开端口被占或防火墙拦截换一个本地端口如58091或放行防火墙说了口令没反应账号没绑定成功或设备没勾选回设置页重新保存确认设备列表里勾上了音箱有歌但播不出声音箱型号不支持该格式打开【转换为MP3】和【型号兼容模式】选项九、进阶玩法3个让工具更实用的隐藏技巧1. 定时叫醒服务定时任务XiaoMusic支持定时播放可以设置每天早上8点播放晨间歌单还能指定只在工作日执行。定时逻辑的源码在xiaomusic/crontab.py支持在表达式末尾加#workday仅工作日或#offday仅休息日比如0 8 * * * #workday就是工作日早上8点。2. 自定义你的专属口令设置页里有完整的口令映射表比如播放歌曲下一首加入收藏分钟后关机。你可以把播放歌曲改成放首歌让它更符合你的说话习惯。口令配置的完整示例参考项目里的config-example.json文件。3. 网络歌单导入除了本地音乐XiaoMusic还支持JSON格式的网络歌单。在设置页填入歌单地址就能用语音播放网上的电台和歌曲实现本地在线双路点歌。插件相关的配置说明可以在xiaomusic/plugins-config-example.json里找到。十、验收清单确认你彻底成功了对照下面几条全绿就是满分毕业✅ 浏览器能打开http://你的设备IP:58090管理界面✅ 设置页里能看到并选中你的小爱音箱✅ 本地歌曲出现在列表里刷新后能正常显示✅ 对小爱说播放歌曲歌名音箱成功出声✅ 说下一首停止播放等口令音箱乖乖执行最后想说语音控制说句话就能点歌、切歌、收藏彻底解放双手一键部署Docker打包所有依赖6步走完全程格式全面MP3、FLAC、WAV等主流格式通吃⏰定时播放让音乐成为你的闹钟和助眠伙伴可玩性强口令自定义、网络歌单、插件扩展想怎么玩都行下一步行动建议先把项目代码克隆到本地备用git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic按第1步创建目录和compose文件启动服务绑定小米账号勾选你的音箱塞进几首喜欢的歌说出第一句点歌口令当你下班回家一句播放歌曲晴天就让客厅响起熟悉的旋律时你会觉得这半小时的折腾特别值。去吧你的小爱音箱正在等你说出第一句点歌口令。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
保姆级教程：如何用6步完成XiaoMusic部署，让小爱音箱播放你的私人音乐库
保姆级教程如何用6步完成XiaoMusic部署让小爱音箱播放你的私人音乐库【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic是一款能让小爱音箱播放本地和在线音乐的开源工具音乐下载交给yt-dlp完成。你只需要对小爱同学说一句播放周杰伦的晴天音箱就会立刻响起你收藏的高品质音乐。这篇文章用6个步骤带你完成全部部署全程不涉及任何专业术语照着做就行。这就是部署成功后的管理界面左侧控制音箱中间管理歌曲一目了然一、6件事做完就成功我把整个部署过程拆成了6件小事做完第6件你就可以对着小爱音箱点歌了✅ 第1件准备两个抽屉目录和一份部署清单compose文件✅ 第2件把XiaoMusic放进抽屉启动容器✅ 第3件在浏览器里打开控制台✅ 第4件让工具认领你的小爱音箱绑定小米账号✅ 第5件往抽屉里塞进你的音乐✅ 第6件验收——说出第一句点歌口令原理小卡片XiaoMusic到底在忙什么它就像一个翻译官小爱音箱只会说小米话你的音乐库只会文件话。XiaoMusic负责把你说的话翻译成音箱能执行的命令播放、暂停、切歌再把音乐文件喂给音箱播放。整个过程中yt-dlp负责在你想听的歌不存在时帮你从网上把它下载下来。二、第1件准备两个抽屉和一份部署清单容器技术Docker就像给你准备了一个独立的小房间所有软件依赖都装在里面不会弄乱你的电脑。我们要做的是建两个目录一个放音乐一个放配置mkdir -p /xiaomusic_music /xiaomusic_conf这句话的意思是在电脑上创建两个文件夹。/xiaomusic_music专门放歌/xiaomusic_conf专门放账号密码等设置。两个分开互不打扰。写一份部署清单新建一个名为docker-compose.yml的文件内容如下services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf如果你在国内网络下载镜像比较慢可以把第一行的镜像地址换成docker.hanxi.cc/hanxi/xiaomusic速度会快很多。人话解释58090:8090是说浏览器访问58090端口容器内部用8090端口后面访问网页时你会用到58090/xiaomusic_music:/app/music是把你的音乐文件夹和容器里的音乐文件夹打通你往左边放歌容器就能在右边看到。三、第2件启动你的XiaoMusic清单写好后回到命令行一条命令启动docker compose up -d人话告诉Docker按这份清单把XiaoMusic跑起来。-d表示在后台运行不会占着你的终端窗口。启动后看一眼状态确认它在正常运行docker ps | grep xiaomusic如果看到了xiaomusic这一行说明容器已经跑起来了。四、第3件在浏览器里打开控制台打开你常用的浏览器输入http://你的设备IP:58090你的设备IP指的是运行Docker的那台电脑/NAS的局域网地址比如192.168.1.100那么地址就是http://192.168.1.100:58090。避坑提示如果你打不开网页先检查58090端口是不是被其他程序占用了另外别忘了看防火墙很多新手的网页打不开都是被防火墙拦下的。打开后你会看到一个清爽的音乐管理界面右边是歌曲列表左边是功能菜单这就是你未来控制音箱的总指挥台。五、第4件让工具认领你的小爱音箱这是整个部署中唯一需要动脑子的一步但也只是填两个框、点几下鼠标在界面左侧找到账号设置输入你的小米账号和密码点保存等待几秒它会自动获取你家的小米设备列表刷新页面在设备列表里勾选你要控制的那台小爱音箱再次保存完成绑定安全提醒账号密码相当于你家的门钥匙请只在自家WiFi环境下配置别在公共网络里操作。另外强烈建议不要把这个小米账号绑定摄像头等隐私设备万一泄露后果严重。绑定成功后左侧的小爱设备控制菜单里就能看到你的音箱了播放列表下方也可以随时切换音箱设备。原理小卡片为什么要绑定账号小爱音箱只听小米官方的话。XiaoMusic拿着你的小米账号以官方身份去和音箱对话音箱才愿意执行命令。这就是为什么第一步必须绑定账号——没有这层身份音箱会把你当成陌生人。六、第5件往抽屉里塞进你的音乐把音乐文件直接放进/xiaomusic_music文件夹即可。XiaoMusic会自动扫描这个目录支持下面这些格式格式说明MP3最常见的音频格式兼容性最好FLAC / WAV无损音质追求CD级体验APE / OGG / M4A小众格式也能播放避坑提示如果你家的音箱是老型号比如L05B、L05C可能不支持FLAC这类无损格式。遇到歌有但播不出来的情况去设置里打开【转换为MP3】让XiaoMusic先把歌转成音箱能听的格式再播放。放进音乐后在界面的歌曲列表里刷新一下就能看到你的歌单了。如果某个文件夹的歌很多XiaoMusic还会自动按文件夹把它变成一个歌单。七、第6件验收说出你的第一句点歌口令一切就绪现在走到你的小爱音箱前对它说播放歌曲周杰伦的晴天如果音箱响起了你熟悉的旋律恭喜你部署成功八、翻车现场三个最常见的坑我身边好几个朋友都是栽在这三处提前看一眼能帮你省下半小时症状原因自救办法网页打不开端口被占或防火墙拦截换一个本地端口如58091或放行防火墙说了口令没反应账号没绑定成功或设备没勾选回设置页重新保存确认设备列表里勾上了音箱有歌但播不出声音箱型号不支持该格式打开【转换为MP3】和【型号兼容模式】选项九、进阶玩法3个让工具更实用的隐藏技巧1. 定时叫醒服务定时任务XiaoMusic支持定时播放可以设置每天早上8点播放晨间歌单还能指定只在工作日执行。定时逻辑的源码在xiaomusic/crontab.py支持在表达式末尾加#workday仅工作日或#offday仅休息日比如0 8 * * * #workday就是工作日早上8点。2. 自定义你的专属口令设置页里有完整的口令映射表比如播放歌曲下一首加入收藏分钟后关机。你可以把播放歌曲改成放首歌让它更符合你的说话习惯。口令配置的完整示例参考项目里的config-example.json文件。3. 网络歌单导入除了本地音乐XiaoMusic还支持JSON格式的网络歌单。在设置页填入歌单地址就能用语音播放网上的电台和歌曲实现本地在线双路点歌。插件相关的配置说明可以在xiaomusic/plugins-config-example.json里找到。十、验收清单确认你彻底成功了对照下面几条全绿就是满分毕业✅ 浏览器能打开http://你的设备IP:58090管理界面✅ 设置页里能看到并选中你的小爱音箱✅ 本地歌曲出现在列表里刷新后能正常显示✅ 对小爱说播放歌曲歌名音箱成功出声✅ 说下一首停止播放等口令音箱乖乖执行最后想说语音控制说句话就能点歌、切歌、收藏彻底解放双手一键部署Docker打包所有依赖6步走完全程格式全面MP3、FLAC、WAV等主流格式通吃⏰定时播放让音乐成为你的闹钟和助眠伙伴可玩性强口令自定义、网络歌单、插件扩展想怎么玩都行下一步行动建议先把项目代码克隆到本地备用git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic按第1步创建目录和compose文件启动服务绑定小米账号勾选你的音箱塞进几首喜欢的歌说出第一句点歌口令当你下班回家一句播放歌曲晴天就让客厅响起熟悉的旋律时你会觉得这半小时的折腾特别值。去吧你的小爱音箱正在等你说出第一句点歌口令。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考