当前位置：首页 > news >正文

如何让小爱音箱变身你的私人音乐管家：XiaoMusic终极配置指南

news 2026/8/7 10:35:42

如何让小爱音箱变身你的私人音乐管家：XiaoMusic终极配置指南

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

你是否曾经想过，让小爱音箱不仅仅是一个简单的智能助手，而是成为你的专属音乐管家？当你厌倦了在线音乐平台的版权限制，或者想要完全掌控自己的音乐库时，XiaoMusic就是你一直在寻找的解决方案！这个开源项目能让你的小爱音箱播放本地音乐，支持多种格式，让你真正拥有自己的音乐世界。想象一下，只需对音箱说一句"播放周杰伦的晴天"，就能听到你珍藏的本地音乐，这种体验是不是很酷？

从零开始：打造你的专属音乐系统

🎯 第一步：快速部署XiaoMusic服务

XiaoMusic的安装过程非常简单，无论你是技术新手还是有经验的开发者，都能在几分钟内完成部署。让我们从获取项目源码开始：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic

接下来，使用Docker快速启动服务，这是最推荐的方式：

services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /your/music/path:/app/music - /your/config/path:/app/conf

关键提示：记得将/your/music/path替换为你实际的音乐文件夹路径，/your/config/path则是配置文件存储路径。启动后，在浏览器访问http://你的IP:58090就能看到控制界面了！

🎨 直观的用户界面设计

XiaoMusic的界面设计非常人性化，分为几个清晰的功能区域。左侧是小爱音箱控制面板，你可以设置音箱关机时间、管理播放列表、进行账号配置等。中间区域是歌曲列表，支持分类查看和快速搜索。底部则是播放控制区，包含播放/暂停、上一首/下一首、随机播放等功能按钮。

从上图可以看到，界面采用了现代化设计风格，功能分区明确。顶部的搜索框让你能快速找到想听的歌曲，设备切换功能支持在多台小爱音箱之间无缝切换。歌曲播放时，封面会动态旋转，带来沉浸式的视觉体验。

语音控制：让小爱听懂你的音乐需求

🎤 丰富的语音指令支持

XiaoMusic最强大的功能之一就是完整的语音控制支持。你不需要拿起手机或打开电脑，只需对小爱音箱说出指令，就能完成各种音乐操作：

基础播放控制："播放本地歌曲"、"下一首"、"上一首"、"停止播放"
播放模式切换："随机播放"、"单曲循环"、"全部循环"
歌单管理："播放歌单收藏"、"播放歌单其他"
收藏功能："加入收藏"、"取消收藏"

🔧 自定义语音指令配置

你还可以根据自己的习惯定制语音指令！在配置文件config-example.json中，有一个专门的key_word_dict部分，你可以修改或添加自己的语音指令：

{ "key_word_dict": { "播放我的最爱": "play_music_list#我的最爱", "晚安音乐": "play_music_list#睡眠音乐", "播放周杰伦": "play#周杰伦" } }

这样，你就可以创建个性化的语音控制体验，比如对音箱说"播放我的最爱"，它就会自动播放你收藏的歌曲列表。

音乐库管理：智能化组织你的音乐收藏

📁 自动扫描与分类

XiaoMusic会自动扫描你指定的音乐目录，识别MP3、FLAC、WAV、APE、OGG、M4A等多种音频格式。系统会提取歌曲的元数据信息，包括歌曲名、艺术家、专辑等，并自动进行分类。

界面顶部的分类标签让你可以快速筛选"全部"、"所有歌曲"、"收藏"、"下载"等不同类型的音乐。双击任意歌曲即可快速播放，右键菜单提供更多操作选项。

🎵 播放列表的智能管理

XiaoMusic支持创建和管理多个播放列表，系统默认提供"收藏"和"下载"列表。你可以轻松地将歌曲添加到不同列表，创建个性化的播放体验。

动态演示展示了播放列表的展开和收起功能，就像手风琴一样流畅。左侧是小爱音箱控制面板，右侧是播放列表区域，点击列表名称即可展开查看详细内容。

高级功能：解锁更多可能性

🔌 插件系统扩展

XiaoMusic内置了强大的插件系统，让你可以扩展更多实用功能。项目提供了几个核心插件：

AI功能插件：plugins/ai/ - 集成智能对话和音乐推荐功能
网络请求插件：plugins/httpget.py - 支持HTTP请求功能
自定义插件：支持JavaScript插件扩展

你可以在配置文件中启用这些插件，或者开发自己的插件来满足特定需求。

📡 网络歌单与电台支持

除了本地音乐，XiaoMusic还支持网络歌单功能！你可以配置JSON格式的歌单文件，包含在线电台和网络歌曲链接。系统还提供了M3U文件转换工具，让你能轻松将电台列表转换为XiaoMusic可用的格式。

🎧 多设备同步播放

如果你家里有多台小爱音箱，XiaoMusic可以同时管理它们！在设备控制面板中，你可以选择不同的音箱进行播放，甚至实现多房间同步播放功能。

配置优化：让体验更完美

🔧 关键配置项详解

配置文件是XiaoMusic的核心，让我们看看几个最重要的配置项：

{ "music_path": "/path/to/your/music/library", "hostname": "http://192.168.2.5", "port": 8090, "enable_fuzzy_match": true, "fuzzy_match_cutoff": 0.6 }