5分钟搞定小爱音箱音乐服务新手必看的xiaomusic配置指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你是否想让小爱音箱播放本地音乐库但又不想受限于在线音乐平台的版权限制xiaomusic开源项目正是为你量身打造的完美解决方案这个项目让你能够通过简单配置让小爱音箱播放本地音乐文件同时保留完整的语音控制功能。无论你是技术小白还是资深玩家都能在5分钟内完成配置享受无限听歌的自由。为什么选择xiaomusic在开始配置前我们先了解一下xiaomusic的核心优势特性传统方式xiaomusic方案音乐来源依赖在线平台支持本地音乐网络下载语音控制部分受限完整语音指令支持设备支持有限型号20款小爱音箱型号配置难度复杂繁琐简单5步完成费用会员订阅完全免费开源第一步准备工作与环境检查在开始配置前确保你已准备好以下条件硬件要求一台小爱音箱设备支持20型号一台电脑或NAS服务器稳定的家庭WiFi网络软件要求Docker环境推荐方式或Python 3.8环境小米账号用于设备绑定网络环境确保小爱音箱和运行xiaomusic的设备在同一局域网开放8090端口访问权限第二步快速安装部署Docker方式这是最推荐的新手安装方式只需3条命令Docker Compose一键部署创建docker-compose.yml文件内容如下version: 3 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 -dDocker直接运行如果你更喜欢单条命令docker run -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic小贴士/xiaomusic_music是你的音乐存放目录可以替换为任何本地路径。58090是网页访问端口可以在浏览器中通过http://你的IP:58090访问管理界面。第三步网页控制台配置设备服务启动后打开浏览器访问管理界面你会看到直观的操作面板小爱音箱控制面板功能指引界面设备配置流程登录小米账号点击左侧导航栏的小爱设备控制输入你的小米账号和密码点击保存配置获取设备DID系统会自动发现局域网内的小爱音箱从设备列表中选择你要控制的小爱音箱复制设备的DID设备标识符环境变量设置如果自动发现失败手动设置环境变量Linux/Mac系统export MI_DID你的设备DID docker-compose up -dWindows系统set MI_DID你的设备DID docker-compose up -d如何找到设备DID方法操作步骤适合人群小米音箱App设备详情 → 查看设备信息所有用户网页控制台自动发现 → 复制DID已启动服务路由器后台查看已连接设备MAC地址技术用户第四步音乐管理与播放设置添加本地音乐库将你的音乐文件放入配置的目录# 假设你的音乐在 ~/Music 目录 cp -r ~/Music/* /xiaomusic_music/支持的音乐格式包括✅ MP3最常用✅ FLAC无损音质✅ WAV无损音质✅ APE无损音质✅ OGG开源格式✅ M4AAAC格式语音指令配置xiaomusic支持丰富的语音指令你可以在config-example.json文件中自定义音乐播放列表内容浏览界面常用语音指令示例播放歌曲周杰伦- 播放周杰伦的歌曲下一首- 切换到下一首歌单曲循环- 设置单曲循环模式播放歌单收藏- 播放收藏列表分钟后关机- 定时停止播放高级功能配置在配置文件中你可以启用以下高级功能{ convert_to_mp3: true, // 自动转换为MP3格式 enable_file_watch: true, // 监控音乐文件夹变化 enable_auto_clean_temp: true // 自动清理临时文件 }第五步测试与问题排查功能测试清单完成配置后按顺序测试以下功能基础连接测试访问http://你的IP:58090确认网页正常检查设备列表中显示你的小爱音箱音乐播放测试在网页界面点击一首歌播放确认小爱音箱开始播放音乐语音控制测试对小爱音箱说播放歌曲测试下一首、暂停等指令常见问题快速解决问题现象可能原因解决方案网页无法访问端口被占用修改docker-compose中的端口映射设备未发现不在同一网络确保设备在同一WiFi网络音乐无法播放格式不支持启用convert_to_mp3选项语音指令无效指令配置错误检查config.json中的key_word_dict日志查看与调试如果遇到问题查看日志是最有效的排查方法# 查看容器日志 docker logs xiaomusic # 实时查看日志 docker logs -f xiaomusic # 下载详细日志文件 # 在网页设置页面底部点击下载日志文件进阶配置技巧多设备支持如果你有多台小爱音箱可以这样配置# 用逗号分隔多个DID export MI_DIDDID1,DID2,DID3网络歌单功能xiaomusic支持网络歌单只需配置一个JSON文件{ music_list_url: https://example.com/playlist.json, custom_play_list_json: /path/to/local/playlist.json }定时任务设置通过crontab功能实现自动化{ crontab_json: /path/to/crontab.json }在crontab.json中配置定时播放任务[ { time: 08:00, action: play, args: [早安音乐] } ]安全注意事项重要提醒保护你的账号安全密码保护如果公开访问务必设置HTTP认证密码使用强密码保护管理界面网络安全不要在公共WiFi环境下使用避免将服务暴露在公网账号分离建议使用专门的小米账号不要绑定摄像头等敏感设备最佳实践总结经过以上步骤你已经成功配置了xiaomusic服务。让我们回顾一下关键要点✅ 配置检查清单Docker服务正常运行网页控制台可访问设备DID正确配置音乐文件已放入指定目录语音指令测试通过 日常使用建议定期更新关注项目更新获取新功能备份配置定期备份config.json文件清理空间设置自动清理临时文件参与社区遇到问题在GitHub Issues提问 未来功能展望项目作者正在开发更多实用功能 更智能的设备自动发现 移动端APP优化 更多主题界面选择 插件系统扩展开始你的音乐之旅吧现在你的小爱音箱已经变身为全能音乐播放器。无论是早晨的唤醒音乐、工作时的背景音还是睡前的放松曲目都可以通过简单的语音指令来控制。记住xiaomusic的核心价值在于自由——让你完全掌控自己的音乐体验不受平台限制不被会员绑定。享受技术带来的便利同时保持对个人数据的完全控制。如果在使用过程中有任何问题或建议欢迎到项目的GitHub页面参与讨论。开源社区的力量会让这个项目越来越好而你的每一次使用和反馈都是对项目发展的宝贵支持。立即开始访问https://gitcode.com/GitHub_Trending/xia/xiaomusic获取最新版本开启你的小爱音箱音乐自由之旅【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
5分钟搞定小爱音箱音乐服务：新手必看的xiaomusic配置指南
5分钟搞定小爱音箱音乐服务新手必看的xiaomusic配置指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你是否想让小爱音箱播放本地音乐库但又不想受限于在线音乐平台的版权限制xiaomusic开源项目正是为你量身打造的完美解决方案这个项目让你能够通过简单配置让小爱音箱播放本地音乐文件同时保留完整的语音控制功能。无论你是技术小白还是资深玩家都能在5分钟内完成配置享受无限听歌的自由。为什么选择xiaomusic在开始配置前我们先了解一下xiaomusic的核心优势特性传统方式xiaomusic方案音乐来源依赖在线平台支持本地音乐网络下载语音控制部分受限完整语音指令支持设备支持有限型号20款小爱音箱型号配置难度复杂繁琐简单5步完成费用会员订阅完全免费开源第一步准备工作与环境检查在开始配置前确保你已准备好以下条件硬件要求一台小爱音箱设备支持20型号一台电脑或NAS服务器稳定的家庭WiFi网络软件要求Docker环境推荐方式或Python 3.8环境小米账号用于设备绑定网络环境确保小爱音箱和运行xiaomusic的设备在同一局域网开放8090端口访问权限第二步快速安装部署Docker方式这是最推荐的新手安装方式只需3条命令Docker Compose一键部署创建docker-compose.yml文件内容如下version: 3 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 -dDocker直接运行如果你更喜欢单条命令docker run -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic小贴士/xiaomusic_music是你的音乐存放目录可以替换为任何本地路径。58090是网页访问端口可以在浏览器中通过http://你的IP:58090访问管理界面。第三步网页控制台配置设备服务启动后打开浏览器访问管理界面你会看到直观的操作面板小爱音箱控制面板功能指引界面设备配置流程登录小米账号点击左侧导航栏的小爱设备控制输入你的小米账号和密码点击保存配置获取设备DID系统会自动发现局域网内的小爱音箱从设备列表中选择你要控制的小爱音箱复制设备的DID设备标识符环境变量设置如果自动发现失败手动设置环境变量Linux/Mac系统export MI_DID你的设备DID docker-compose up -dWindows系统set MI_DID你的设备DID docker-compose up -d如何找到设备DID方法操作步骤适合人群小米音箱App设备详情 → 查看设备信息所有用户网页控制台自动发现 → 复制DID已启动服务路由器后台查看已连接设备MAC地址技术用户第四步音乐管理与播放设置添加本地音乐库将你的音乐文件放入配置的目录# 假设你的音乐在 ~/Music 目录 cp -r ~/Music/* /xiaomusic_music/支持的音乐格式包括✅ MP3最常用✅ FLAC无损音质✅ WAV无损音质✅ APE无损音质✅ OGG开源格式✅ M4AAAC格式语音指令配置xiaomusic支持丰富的语音指令你可以在config-example.json文件中自定义音乐播放列表内容浏览界面常用语音指令示例播放歌曲周杰伦- 播放周杰伦的歌曲下一首- 切换到下一首歌单曲循环- 设置单曲循环模式播放歌单收藏- 播放收藏列表分钟后关机- 定时停止播放高级功能配置在配置文件中你可以启用以下高级功能{ convert_to_mp3: true, // 自动转换为MP3格式 enable_file_watch: true, // 监控音乐文件夹变化 enable_auto_clean_temp: true // 自动清理临时文件 }第五步测试与问题排查功能测试清单完成配置后按顺序测试以下功能基础连接测试访问http://你的IP:58090确认网页正常检查设备列表中显示你的小爱音箱音乐播放测试在网页界面点击一首歌播放确认小爱音箱开始播放音乐语音控制测试对小爱音箱说播放歌曲测试下一首、暂停等指令常见问题快速解决问题现象可能原因解决方案网页无法访问端口被占用修改docker-compose中的端口映射设备未发现不在同一网络确保设备在同一WiFi网络音乐无法播放格式不支持启用convert_to_mp3选项语音指令无效指令配置错误检查config.json中的key_word_dict日志查看与调试如果遇到问题查看日志是最有效的排查方法# 查看容器日志 docker logs xiaomusic # 实时查看日志 docker logs -f xiaomusic # 下载详细日志文件 # 在网页设置页面底部点击下载日志文件进阶配置技巧多设备支持如果你有多台小爱音箱可以这样配置# 用逗号分隔多个DID export MI_DIDDID1,DID2,DID3网络歌单功能xiaomusic支持网络歌单只需配置一个JSON文件{ music_list_url: https://example.com/playlist.json, custom_play_list_json: /path/to/local/playlist.json }定时任务设置通过crontab功能实现自动化{ crontab_json: /path/to/crontab.json }在crontab.json中配置定时播放任务[ { time: 08:00, action: play, args: [早安音乐] } ]安全注意事项重要提醒保护你的账号安全密码保护如果公开访问务必设置HTTP认证密码使用强密码保护管理界面网络安全不要在公共WiFi环境下使用避免将服务暴露在公网账号分离建议使用专门的小米账号不要绑定摄像头等敏感设备最佳实践总结经过以上步骤你已经成功配置了xiaomusic服务。让我们回顾一下关键要点✅ 配置检查清单Docker服务正常运行网页控制台可访问设备DID正确配置音乐文件已放入指定目录语音指令测试通过 日常使用建议定期更新关注项目更新获取新功能备份配置定期备份config.json文件清理空间设置自动清理临时文件参与社区遇到问题在GitHub Issues提问 未来功能展望项目作者正在开发更多实用功能 更智能的设备自动发现 移动端APP优化 更多主题界面选择 插件系统扩展开始你的音乐之旅吧现在你的小爱音箱已经变身为全能音乐播放器。无论是早晨的唤醒音乐、工作时的背景音还是睡前的放松曲目都可以通过简单的语音指令来控制。记住xiaomusic的核心价值在于自由——让你完全掌控自己的音乐体验不受平台限制不被会员绑定。享受技术带来的便利同时保持对个人数据的完全控制。如果在使用过程中有任何问题或建议欢迎到项目的GitHub页面参与讨论。开源社区的力量会让这个项目越来越好而你的每一次使用和反馈都是对项目发展的宝贵支持。立即开始访问https://gitcode.com/GitHub_Trending/xia/xiaomusic获取最新版本开启你的小爱音箱音乐自由之旅【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
