KABU 使用指南
KABU 全屋音乐基站用户使用说明书
适用固件:v1.9.9 正式版(v1.9.8 / v1.9.7 用户同样适用) 文档版本:3.0 更新日期:2026 年 10 月 18 日
本说明书面向第一次接触 KABU 的普通用户,假设你之前没有接触过同类产品,也不熟悉网络设置。第一次使用请从第 1 章顺着往下读,10 分钟就能听到第一首歌;遇到具体问题时,直接翻到第 16 章"常见问题与故障排除"对号入座。只想快速上手?也可以先看图文快速上手教程。本说明书另提供繁體中文与 English 版本,切换请用页面顶部的语言条。
快速开始:10 分钟听到第一首歌
第 1 步:连接设备
- 先将 KABU 的音频输出连接到功放、有源音箱或对应的音频系统(怎么选线看第 3 章)。
- 将功放或音箱音量先调低,避免第一次播放时音量过大。
- 用自备的 Type-C 电源(建议 5V 1A)为 KABU 供电,设备会自动启动。
第 2 步:让 KABU 连上家里的 Wi-Fi
- 第一次开机时,KABU 会创建一个名为 KABU-XXXX 的临时热点,其中 XXXX 是设备 Wi-Fi 地址的末四位,每台设备不同。
- 用手机或电脑连接这个热点。热点默认不需要密码;如果系统提示"此网络无法访问互联网",请选择继续连接。
- 配网页面通常会自动弹出。如果没有弹出,请在浏览器中输入 http://192.168.4.1。
- 点击"更改 Wi-Fi 网络"或"扫描网络",选择家里的 2.4 GHz Wi-Fi,输入密码后点击"连接"。密码输错了也不用担心,页面会直接提示密码错误,改对再连即可。
- 手机会与 KABU 热点断开,这是正常现象。让手机重新连接家里的 Wi-Fi,等待 KABU 完成联网。
第 3 步:双击选模式,第一次播放
先看灯色确认当前模式:白色AirPlay、琥珀色网络电台、青色DLNA。不是想要的模式,就双击设备按键切换到下一个,几秒完成、无需重启。
最省事的方式是使用 AirPlay:
- 确认 KABU 处于 AirPlay 模式,待机时灯光为白色慢呼吸。
- 在 iPhone 或 iPad 打开"控制中心",点击播放卡片上的 AirPlay 图标。
- 选择 KABU-XXXXXXXX 或你设置的名称,再播放音乐。
- 从较低音量开始,确认声音正常后再逐步调高。
如果使用 Android 或 Windows,请双击设备按键切到 DLNA 模式(青色),再用支持 DLNA/UPnP 的播放应用选择 KABU。
第 4 步:建议马上完成的两个设置
- 在路由器的客户端列表中找到 KABU 的 IP 地址,然后在浏览器打开
http://<设备IP>。建议为它设置"固定租约/地址保留"。 - 在"设备"区域把名称改成容易辨认的名字,例如"客厅 KABU"或"书房 KABU";多台设备务必使用不同名称。
- 在"系统信息"中确认固件版本为 1.9.9。
内容导航
- 先弄懂几个名词(新手词典)
- 产品简介与 v1.9.9 重点改进
- 使用前准备与安全提醒
- 认识设备
- 首次联网与更换 Wi-Fi
- 按钮操作(含双击切换模式)
- LED 灯光说明
- 三种播放模式怎么选
- AirPlay 使用方法
- 网络电台使用方法
- DLNA 使用方法
- Web 管理页面完整说明
- 音效、灯光、睡眠定时和漫游
- Home Assistant 与智能家居
- 固件升级、重启与日常维护
- 常见问题与故障排除
- 技术规格与快速参考卡
1. 先弄懂几个名词(新手词典)
这一页把说明书里会反复出现的词一次讲清楚。已经熟悉的读者可以跳过。
KABU 本身不发声。 它是一台"Wi-Fi 音乐接收盒":音乐从手机、电脑或网络传给它,它通过音频线把声音交给你的功放或有源音箱播出来。所以使用 KABU 需要两样东西——一套能发声的音响系统,和家里的 Wi-Fi。
AirPlay:苹果设备(iPhone、iPad、Mac)自带的"投放声音"功能。在控制中心点一下,就能把正在听的音乐送到 KABU。不需要安装任何 App。
DLNA:一种通用的"投放到设备"标准。Android 手机、Windows 电脑、NAS 以及很多播放器 App 都支持。用支持 DLNA 的播放 App 把音乐"推"给 KABU。
网络电台:KABU 自己直接从互联网收听广播电台,类似传统收音机,但节目来自网络。不需要手机一直开着播放。
固件:设备里运行的"系统程序"。升级固件可以获得新功能、修复问题,类似手机升级系统。
IP 地址:设备在家庭网络里的"门牌号",形如 192.168.1.67。在浏览器里输入这个地址,就能打开 KABU 的管理页面。
2. 产品简介与 v1.9.9 重点改进
KABU 是一款通过 Wi-Fi 接收音频的全屋音乐基站。它可以接收 Apple 设备的 AirPlay 音频,也可以播放网络电台、接收 DLNA 推送。
2.1 主要功能
- AirPlay / AirPlay 2:适合 iPhone、iPad 和 Mac,操作简单,支持多房间播放,也可以和 HomePod、Apple TV 组成一组一起响。
- 网络电台:内置 6 个中文电台,也可添加自己的电台直播地址,最多收藏 200 个。
- DLNA:适合 Android、Windows、NAS 和各种支持 UPnP/DLNA 的播放器,支持无损音乐的高品质输出。
- 专业均衡器:提供 15 段图示 EQ 和 8 段参数 EQ,内置多种预设,可以按喜好调音。
- Web 管理:无需安装专用应用,手机浏览器即可配置网络、设备名、灯光和固件。
- 智能家居:支持 MQTT,可接入 Home Assistant 等智能家居平台。
- 无线升级:支持网页升级、双固件槽和启动回滚保护,升级失败也能自动退回可用版本。
注意:KABU 正式产品不提供蓝牙音频播放。手机能搜索到蓝牙设备并不代表 KABU 支持蓝牙投音,请使用 AirPlay、DLNA 或网络电台。
2.2 v1.9.9 的重点改进
v1.9.9 集中解决了此前版本最容易遇到的几类问题,日常使用会明显更省心:
- 暂停、继续、切歌,一点就有声:修复 AirPlay 投放时暂停没反应、暂停久了再继续会掉线、起播和切歌慢半拍的问题。
- 设备不再"重启后就消失":修复设备重启后偶尔连不上家里 Wi-Fi、从投送列表里凭空消失的问题。
- 长时间使用依然顺手:修复连续开机很久之后,切到 DLNA 模式偶尔切不过去、需要重启的问题。
- 高品质音乐正常播:修复部分高规格音乐文件(24bit/96kHz)播放速度异常、听感变调的问题。
- 配网更宽容:Wi-Fi 密码输错时,配网页面会直接提示错误原因,不再"记住"错误密码反复重试;长按按键总能可靠唤出配网热点。万一配网卡住,用电脑打开官网的「网络唤醒 · 一键清除网络配置」页面即可自助恢复。
- 和 HomePod 一起放更稳:三台 KABU 与 HomePod 组成一组连播一小时,人耳全程听不出先后。
3. 使用前准备与安全提醒
3.1 开箱后请先确认
包装内只有 KABU 主机一台,不含电源适配器,也不含任何音频线,以下物品需要自备:
- Type-C 电源:一根 Type-C 数据线 + 一个电源适配器,建议 5V 1A(普通手机充电器即可,不需要大功率)
- 与功放或有源音箱匹配的音频连接线(怎么选看第 4.1 节)
- 可用的 2.4 GHz Wi-Fi 网络
- 一台用于配网和播放的手机、平板或电脑
3.2 安全提醒
- 使用正规的 5V 1A 电源适配器为设备供电,不要使用劣质或功率不明的电源。
- 接插音频线之前,先关闭功放或把音量调低。
- 不要在潮湿、滴水、高温、密闭或通风不良的位置使用设备。
- 不要覆盖设备,也不要把设备紧贴高热量功放的散热口。
- 固件升级过程中不要断电、拔线或刷新关闭页面。
3.3 网络要求
- KABU 使用 2.4 GHz Wi-Fi,不直接连接 5 GHz Wi-Fi。
- 手机可以连接 5 GHz,只要手机和 KABU 仍在同一个局域网,并且路由器允许 2.4 GHz 与 5 GHz 设备互相访问。
- 路由器不应开启"AP 隔离""客户端隔离"或"访客网络隔离",否则手机可能发现不了 KABU。
- 多房间播放建议把设备放在信号稳定的位置;信号差时先改善网络,再调整音效。
4. 认识设备
4.1 常用部件
| 部件 | 用途 |
|---|---|
| 电源接口 | 连接自备的 Type-C 电源适配器(建议 5V 1A) |
| 音频输出 | 连接功放、有源音箱或对应音频系统;接口外观以实际机型为准 |
| 多功能按钮 | 单击、双击和长按分别执行不同操作,详见第 6 章 |
| RGB 指示灯 | 显示启动、联网、模式、播放、按键和故障状态 |
音频线怎么选
KABU 的 3.5mm 输出是模拟音频信号,按下游设备选一种接法:
| 下游设备 | 需要的声音线 |
|---|---|
| 功放 / 无源音箱 | 3.5mm → RCA 立体声线(一端接 KABU,红白插头接功放 AUX/RCA 输入,红对红、白对白) |
| 有源音箱 | 3.5mm → 3.5mm 线(两端均为 3.5mm 插头,一头插 KABU,一头插音箱 AUX IN) |
一个常见误区:如果功放只有光纤、同轴这类数字输入,KABU 不能直接插上去,需要功放上有一组模拟输入(AUX/RCA)才行。
4.2 建议的开机顺序
- 先连接音频线。
- 把功放或音箱音量调低。
- 给 KABU 供电。
- 等待 KABU 完成联网并进入待机。
- 开始播放后,再逐步调到合适音量。
4.3 建议的关机顺序
- 先停止手机或播放应用中的音乐。
- 将功放或音箱音量调低。
- 再关闭 KABU 或音频系统电源。
5. 首次联网与更换 Wi-Fi
5.1 第一次开机配网
设备没有保存 Wi-Fi 信息时,会自动开启配网热点。
- 等待 LED 由启动灯效进入紫色慢呼吸。
- 打开手机"设置 → Wi-Fi"。
- 连接 KABU-XXXX。XXXX 为设备 Wi-Fi 地址末尾四位,因此每台设备都不同。
- 如果手机提示"无互联网连接",请选择"保持连接"或"仍然使用此网络"。
- 等待配网页面自动出现;没有出现时,手动打开
http://192.168.4.1。 - 点击"更改 Wi-Fi 网络",再点击"扫描网络"。
- 选择家里的 2.4 GHz Wi-Fi,输入密码,点击"连接"。
- 密码错误时页面会提示错误原因,核对后重新输入即可;设备会保留热点等你重试,不会"消失"。
- 连接成功后页面提示已保存并重启,等待约 20~30 秒,手机重新连接家庭 Wi-Fi。
成功标志:KABU 的灯先变橙色呼吸(正在连接家里的 Wi-Fi),几十秒内变成白色、琥珀色或青色的慢呼吸——这就是它的待机灯,说明联网完成。
5.2 找到设备的管理地址
联网成功后,KABU 会从路由器获得一个局域网 IP 地址。推荐使用以下方法查找:
- 打开路由器管理页面或路由器 App。
- 进入"已连接设备""终端管理"或类似页面。
- 查找名称为 KABU-XXXXXXXX 或你设置的名称的设备,并记录 IP,例如 192.168.1.67。
- 在浏览器输入
http://192.168.1.67。
设备名称和路由器对本地域名的处理可能不同。管理页面请优先使用路由器显示的 IP 地址。
建议在路由器中为每台 KABU 设置"固定租约"或"地址保留"。这样 IP 不容易变化,以后打开管理页面更方便。也可以使用官网的查找设备页面快速定位局域网内的 KABU。
5.3 更换路由器或 Wi-Fi 密码
如果旧 Wi-Fi 仍然可用:
- 打开 KABU 管理首页。
- 在"Wi-Fi 网络"区域点击"更改 Wi-Fi 网络"。
- 扫描并选择新网络,输入新密码。
- 点击"连接",等待设备重启。
如果旧 Wi-Fi 已经不可用:
- 长按设备按钮约 2 秒,开启配网热点。
- 等待紫色配网灯效出现。
- 连接 KABU-XXXX 热点。
- 打开
http://192.168.4.1,重新配置网络。
5.4 临时热点会自动关闭
长按按钮开启的是临时配网热点。无人连接时,它会在约 10 分钟后自动关闭;再次长按约 2 秒可重新开启并重置计时。关闭热点不会删除已经保存的家庭 Wi-Fi 信息。
万一设备反复连不上 Wi-Fi、热点也唤不出来,可以用一根 USB 线把设备连到电脑,打开官网的「网络唤醒 · 一键清除网络配置」页面,按页面指引清除错误的网络配置,让设备回到配网模式。
6. 按钮操作
KABU 只有一个按钮,但可以识别三种手势。按键完成后,LED 会用闪烁次数进行确认。双击即可在不同模式间切换,这是日常最常用的操作。
| 操作 | 怎么按 | 作用 |
|---|---|---|
| 单击 | 快速按 1 次 | 按当前模式执行播放控制、下一电台或切换 DLNA 音质 |
| 双击 | 连续快速按 2 次(两下要连得快,半秒以内) | 在 AirPlay、网络电台、DLNA 三个模式间循环切换 |
| 长按 | 按住约 2 秒 | 开启临时配网热点;无人连接约 10 分钟后自动关闭 |
6.1 单击在不同模式中的作用
| 当前模式 | 单击作用 |
|---|---|
| AirPlay | 尝试播放/暂停;如果当前 App 不接受远程控制,请在手机端操作 |
| 网络电台 | 切换到下一个电台并播放 |
| DLNA | 切换标准/高品质输出;正在播放时会播报提示并重放当前曲目 |
6.2 双击切换模式
双击按以下顺序循环:
AirPlay → 网络电台 → DLNA → AirPlay
三个模式之间采用热切换,通常几秒内完成,不需要整机重启。切换是否成功,看灯色即可确认。
注意双击的两下要连得快(半秒以内);按键后看到白色闪 2 次即表示切换成功。不小心切过头了?再双击一次就会继续沿这个圈转回去,怎么按都不会坏。
6.3 长按开启配网热点
按住按钮时会显示琥珀色提示。约 2 秒后松开,设备会开启 KABU-XXXX 临时热点;热点已开启时长按会重置 10 分钟自动关闭的计时。长按不会关闭热点,也不会删除已保存的 Wi-Fi 信息。v1.9.9 起,即使设备正处于"反复连不上 Wi-Fi"的状态,长按也总能可靠唤出热点。
7. LED 灯光说明
7.1 模式颜色
| 模式 | 代表颜色 |
|---|---|
| AirPlay | 白色 |
| 网络电台 | 琥珀色 |
| DLNA | 青色 |
7.2 系统状态和灯效
| LED 表现 | 含义 | 用户该做什么 |
|---|---|---|
| 白色启动渐变 | 正在开机 | 等待启动完成 |
| 橙色呼吸 | 正在连接家庭 Wi-Fi | 等待;长时间不消失时检查 Wi-Fi |
| 紫色慢呼吸 | 配网热点已开启 | 连接 KABU-XXXX 并打开 192.168.4.1 |
| 模式颜色慢呼吸 | 网络正常,当前处于待机 | 可以开始投送 |
| 模式颜色低亮常亮 | 已连接音源但处于暂停 | 在 App 或设备上继续播放 |
| KABU Aura 氛围光 | 正在播放 | 正常状态 |
| 随音乐跳动的 VU 灯效 | 正在播放,已选择"音乐律动" | 正常状态 |
| 橙色三连闪,每约 3 秒出现一次 | 网络拥塞或丢包风险上升 | 靠近路由器、减少干扰或更换信道 |
| 红色闪烁 | 设备检测到错误 | 重启一次;仍出现时查看日志或联系支持 |
播放时的 KABU Aura 会使用所选氛围色调,不一定一直显示当前模式色。待机和暂停时,模式颜色最容易识别。
7.3 按键反馈
- 单击完成:白色闪 1 次。
- 双击完成:白色闪 2 次。
- 长按生效:琥珀色确认。
7.4 调整灯光
在管理首页的"设备"区域可以:
- 调整 LED 亮度,0% 相当于关闭灯光。
- 选择"氛围光(KABU Aura)"或"音乐律动(VU)"。
- 为氛围光选择暮色、极光、海洋、余烬或彩虹色调。
这些设置会保存,重启后继续使用。
8. 三种播放模式怎么选
| 你的设备或目的 | 推荐模式 | 原因 |
|---|---|---|
| iPhone、iPad、Mac 日常听歌 | AirPlay | 系统原生支持,操作最简单 |
| 听固定网络广播 | 网络电台 | 不需要手机一直推送 |
| Android、Windows、NAS 或通用播放器 | DLNA | 兼容面广,适合"投放到设备" |
| 多台 AirPlay 音箱一起播放 | AirPlay 2 分组 | 由 Apple 设备直接分组控制 |
8.1 模式互斥
同一台 KABU 同一时间只运行一种播放模式。处于 AirPlay 时它是 AirPlay 音箱,切到 DLNA 后它只作为 DLNA 渲染器出现,彼此不会同时工作。
8.2 开机恢复
设备会恢复上一次成功进入的模式。若某个模式连续启动失败,设备会采用安全回退,重新进入 AirPlay,避免一直卡在不可用状态。
9. AirPlay 使用方法
9.1 iPhone 或 iPad
- 确认手机与 KABU 在同一局域网。
- 将 KABU 切换到 AirPlay 模式,待机灯光为白色慢呼吸。
- 从屏幕右上角向下滑,打开"控制中心"。
- 在播放卡片中点击 AirPlay 图标。
- 选择 KABU-XXXXXXXX 或你设置的名称。
- 播放音乐,并从较低音量开始调节。
也可以在 Apple Music、播客或其他支持 AirPlay 的 App 内直接点击 AirPlay 图标。
9.2 Mac
- 点击菜单栏"控制中心"。
- 打开"声音"或播放控制。
- 在输出设备中选择 KABU-XXXXXXXX 或你设置的名称。
- 也可以在支持 AirPlay 的音乐 App 中单独选择 KABU。
9.3 AirPlay 2 多房间播放
- 先让每台设备都进入 AirPlay 模式。
- 打开 iPhone/iPad 的 AirPlay 面板。
- 同时勾选多台 KABU 或其他 AirPlay 2 音箱(包括 HomePod、Apple TV)。
- 使用 AirPlay 面板统一调整播放和音量。
设备会自动采用 AirPlay 2 发送端协商的播放延迟,无需手动设置。与 HomePod、Apple TV 混合组网的同步表现已经过长期真机验证:三台 KABU 与 HomePod 组成一组连播一小时,人耳全程听不出先后。
音量安全提醒:后加入 AirPlay 2 群组的设备,可能短暂使用它上次保存的音量,随后才收到群组音量。分组前请把各房间设备音量调低,再统一增加音量。
9.4 AirPlay 找不到设备时
- 确认 KABU 是白色模式色,不是青色或琥珀色。
- 确认手机与 KABU 在同一局域网。
- 关闭路由器的 AP/客户端隔离。
- 在 AirPlay 面板下拉刷新,或关闭再打开 Wi-Fi。
- 重启 KABU 和路由器后再试。
Mac 上音乐 App 的投送列表偶尔会整体卡住(点设备没反应、列表缺设备),这通常是 Mac 端媒体服务的临时状态。先重启 Mac 再试;极少数情况下需要联系售后获取 Mac 端服务复位方法。
10. 网络电台使用方法
10.1 进入电台模式
在 AirPlay 模式下双击一次,设备会播报"电台模式",灯光变为琥珀色,并尝试继续播放上次收听的电台;如果没有历史记录,则使用第一个可用电台。
10.2 用按钮听电台
- 单击:下一台并播放。
- 双击:切换到 DLNA 模式。
- 需要停止、上一台、重试或指定某一台时,请使用电台网页。
10.3 打开电台页面
在浏览器打开 http://<设备IP>/radio。
页面从上到下包括:当前电台、节目/音频信息、连接状态、上一台/停止/下一台/重试、音量、电台列表和手动添加区域。
10.4 播放与切换
- 在电台列表中找到想听的电台。
- 点击右侧播放按钮。
- 状态会依次显示"正在连接""缓冲中""正在播放"。
- 如遇暂时性错误,点击"重试"。
- 点击"停止"即可结束播放。
10.5 内置电台
出厂列表包含以下 6 个电台:
- 清晨音乐台
- 中国之声
- 上海新闻广播
- 第一财经
- 深圳新闻广播
- 音乐之声
网络电台地址由第三方提供,可能因运营方调整、地域限制或临时维护而失效。这不一定代表 KABU 出现故障。
10.6 添加自己的电台
- 在电台页面底部输入电台名称。
- 粘贴直接音频流地址,必须以 http:// 或 https:// 开头。
- 点击"添加电台"。
- 添加成功后,新电台会出现在列表底部。
可以使用常见的 MP3、AAC 和兼容 HLS 直播流。普通网页地址、需要登录的页面、RTMP、RTSP、加密 HLS、fMP4 HLS 或非音频链接通常无法播放。
10.7 删除与容量
- 自己添加的电台可点击红色"×"删除。
- 6 个出厂预置电台不能在网页中删除。
- 电台总数上限为 200 个,包含预置电台。
10.8 电台音量
电台页面的音量滑块范围为 0%~100%。设备会记住电台音量,重启或下次回到电台模式时继续使用。
11. DLNA 使用方法
DLNA 适合 Android、Windows、NAS、Home Assistant 以及支持 UPnP/DLNA 的播放器。KABU 作为"数字媒体渲染器"出现,播放应用负责把音频地址发送给它。
11.1 Android 手机
- 双击按钮,直到设备进入 DLNA 模式,灯光为青色。
- 打开支持 DLNA/UPnP Renderer 的播放应用,例如 BubbleUPnP 等。
- 在应用中打开"播放到""渲染器"或"投放设备"。
- 选择 KABU-XXXXXXXX 或你设置的名称。
- 选择音乐并播放。
不同 App 的菜单名称不同,但核心步骤都是:先选择 KABU 作为播放设备,再选择音乐。
11.2 Windows 电脑
可使用支持"投放到设备"或 UPnP Renderer 的播放器:
- 确认电脑与 KABU 在同一局域网。
- 让 KABU 进入 DLNA 模式。
- 在播放器中找到"Cast to device""Play to""Renderer"或类似菜单。
- 选择 KABU-XXXXXXXX 或你设置的名称后开始播放。
11.3 支持的常见音频
DLNA 播放路径支持常见的 MP3、AAC、FLAC、WAV/PCM 音频,也支持双声道 24-bit FLAC 高品质直通。能否播放仍取决于媒体地址、封装、采样参数和网络访问权限。
11.4 播放控制与音量
- 优先在投送 App 中暂停、继续、停止、切歌和调音量。
- 设备单击用于切换 DLNA 标准/高品质输出,不负责暂停或继续。
- DLNA 音量会单独保存,不会直接覆盖网络电台音量。
11.5 标准模式与高品质模式
- 标准模式将网络音频送入固定 48 kHz 的兼容处理链。高品质模式在条件满足时按源采样率输出,减少不必要的重采样。
- 在 DLNA 模式单击设备按钮,可在标准模式和高品质模式之间切换。设备会播放"High quality mode"或"Standard quality mode"英文提示。
- 正在播放时切换,设备会停止当前会话、播报提示并重新播放当前曲目;暂停、继续和停止仍应在投送 App 或网页控制台中操作。
- 高品质模式支持 44.1、48、88.2、96、176.4 和 192 kHz 的兼容源采样率。v1.9.9 修复了部分 24bit/96kHz 文件播放速度异常的问题,高规格无损可以放心使用。24-bit FLAC 高品质直通要求双声道;不兼容格式会自动使用兼容处理路径。
- 高品质设置会保存并在下次 DLNA 播放时继续使用。
11.6 进度条与拖动定位
- 支持通过投送 App 的进度条拖动播放位置,FLAC 音乐拖动卡死的问题已修复。进度条是否显示、定位精度和恢复速度仍取决于 App、媒体服务器及音频文件。
- 带内嵌专辑封面的 FLAC 已纳入实机验证。对于来源异常、封装不标准、需要登录或设备无法访问的媒体地址,仍可能无法播放。
12. Web 管理页面完整说明
12.1 访问地址
管理首页地址是 http://<设备IP>。
常用子页面:
| 页面 | 地址 | 主要用途 |
|---|---|---|
| 设置首页 | / | 网络、MQTT、设备、灯光、睡眠、OTA、系统信息 |
| 专业均衡器 | /eq | 15 段图示 EQ、8 段参数 EQ 与预设 |
| 网络电台 | /radio | 播放、添加、删除电台和调音量 |
| 系统日志 | /logs | 实时查看运行日志,供故障排查 |
| Wi-Fi 测速 | /speedtest | 测试浏览器与 KABU 之间的局域网延迟和吞吐量 |
12.2 Wi-Fi 网络
- "更改 Wi-Fi 网络":展开配网表单。
- "扫描网络":查找附近 Wi-Fi。
- SSID 和密码:可手动输入隐藏网络信息。
- "无缝漫游":用于支持 802.11k/v/r 的同 SSID Mesh/多 AP 环境,默认开启。
单路由器家庭保持默认即可;只有一个节点时不会触发漫游。Mesh 用户请同时阅读第 13.5 节。
12.3 功能入口
首页的"功能"区域提供均衡器、电台、系统日志和 Wi-Fi 测速入口。均衡器入口只在当前固件功能可用时显示。
12.4 MQTT / 智能家居
可以启用 MQTT,填写 Broker 地址、用户名和密码。Broker 地址必须以 mqtt:// 开头,例如 mqtt://192.168.1.10:1883。
12.5 设备
可修改以下内容:
- 设备名称
- LED 亮度
- 灯光效果
- KABU Aura 氛围色调
- 睡眠定时器
设备名称保存后,Web 页面立即更新;DLNA 名称在播放 App 重新发现设备后更新;AirPlay 名称需重新进入 AirPlay 模式或重启后更新。中文设备名的 AirPlay 连接兼容性已改善。
12.6 固件升级
显示当前固件版本、运行分区,并允许选择固件文件上传安装。播放中会拒绝升级,需先停止音乐。
12.7 系统信息
可查看 IP、MAC、设备名称、固件版本、Wi-Fi 名称、信号强度、信道和 PHY 信息。页面底部的"重启设备"会要求再次确认。Mesh 环境还可访问 http://<设备IP>/api/wifi/status 查看当前节点、信号、信道、漫游状态和设备发现状态。
12.8 语言
页面支持中文和 English。语言选择保存在当前浏览器中,不会改变设备语音提示。
12.9 Wi-Fi 测速的正确理解
测速页测量的是手机/电脑浏览器与 KABU 之间的局域网连接,不是运营商互联网速度。它适合判断 KABU 所在位置的 Wi-Fi 延迟、抖动和吞吐是否稳定。
13. 音效、灯光、睡眠定时和漫游
13.1 普通用户如何调 EQ
- 打开
http://<设备IP>/eq。 - 确认"启用均衡器"已开启。
- 初次使用建议选择"15 段图示"。
- 从"温暖""重低音""小音量响度""清晰""轻微 V 形""人声"等预设中选择最接近需求的一项(以页面实际显示为准)。
- 每次只小幅调整 0.5~2 dB,再实机试听。
- 点击"安全应用"。
图示均衡器提供 15 个频段,范围为 -15 dB~+15 dB。页面会计算组合峰值,并自动保留安全余量。
13.2 参数 EQ 适合谁
"8 段参数"适合熟悉频率、增益和 Q 值的用户。可选择峰值、低架、高架、高通和低通等滤波器。建议普通用户优先使用图示 EQ 和保守预设,避免大幅提升多个相邻频段。
大幅提升多个频段时,系统会用软限幅平滑吸收超出的增益以避免硬削波,此时响度可能略有收敛,属于正常保护。
13.3 前级和失真
手动前级只允许衰减。自动前级最多补偿 -3 dB,超出部分由软限幅吸收。系统自动降低总体增益是为避免数字削波,并不是设备音量故障。
13.4 睡眠定时器
管理首页提供以下选项:关闭、15、30、60、90 和 120 分钟。
- 选择时间后立即开始倒计时。
- 页面会显示剩余时间。
- 重新选择时间会替换原倒计时。
- 选择"关闭"可取消。
到时后,电台和 DLNA 会暂停;AirPlay 会尝试通知音源暂停,如果音源不接受控制,KABU 会在本地保证静音。
13.5 无缝漫游
无缝漫游用于同一个 SSID 下有多个 Mesh 节点或 AP 的环境。它会在不主动打断播放的前提下寻找更合适的节点。
建议:
- 单路由器:保持默认即可;只有一个节点时不会触发漫游。
- Mesh 多节点且 KABU 经常移动或位于覆盖交界处:保持开启。
- 开启后反而更不稳定:可在设置页关闭,并在路由器端优化节点、信道和回程。
13.6 Mesh 组网环境
KABU 重点支持同一网络名下的家用 Mesh 或多 AP 网络。AirPlay、DLNA、网络电台、网页管理、OTA 升级和 MQTT 可按原方法使用。
建议设置:
- 保持"无缝漫游"开启。出厂默认值已经开启,单路由器环境不会触发漫游。
- 让手机或音源与 KABU 连接同一个家庭网络,多个 Mesh 节点使用相同的网络名和密码。
- 如果路由器提供"组播优化"或"IGMP 侦听"等选项,请避免设置成阻止局域网设备发现的模式。
使用时请注意:
- 播放期间由路由器引导 KABU 切换节点时,音乐通常可以继续;KABU 主动扫描和切换只在空闲时进行。实际表现仍取决于路由器。
- 如果 AirPlay 或 DLNA 列表暂时找不到 KABU,请重新打开设备列表或等待约 30 秒。仍未出现时,检查路由器的组播或设备隔离设置。
- 漫游或重新分配地址后,AirPlay 和 DLNA 会重新发布设备地址;正在播放的投送会话可能断开,请在手机端重新投送。
需要排查 Mesh 网络时,请访问 http://<设备IP>/api/wifi/status。页面会显示当前节点、信号、信道、漫游状态、最近的节点切换记录以及 AirPlay/DLNA 设备发现状态。
14. Home Assistant 与智能家居
这一章属于进阶功能。只用 AirPlay、网络电台或 DLNA 的读者可以跳过。
14.1 通过 MQTT 接入 Home Assistant
准备条件:
- 局域网中已有可用的 MQTT Broker,例如 Mosquitto。
- Home Assistant 已配置 MQTT 集成,并启用自动发现。
- Home Assistant、Broker 和 KABU 互相可以访问。
操作步骤:
- 打开 KABU 管理首页。
- 在"MQTT / 智能家居"中开启 MQTT。
- 输入 Broker,例如
mqtt://192.168.1.10:1883。 - 如 Broker 要求认证,填写用户名和密码。
- 点击"保存 MQTT 设置"。
- 等待页面显示"已连接"。
- 在 Home Assistant 的"设置 → 设备与服务 → MQTT"中查找 KABU。
自动发现后,通常会出现状态、音源、Wi-Fi 信号、音量、静音、模式、播放/暂停、上一首/下一首、电台名称、媒体信息和网络健康等实体。
14.2 通过 Home Assistant 的 DLNA 集成播放
- 先让 KABU 进入 DLNA 模式。
- 在 Home Assistant 打开"设置 → 设备与服务 → 添加集成"。
- 搜索 DLNA Digital Media Renderer。
- 如果没有自动发现,手动输入
http://<设备IP>:49152/rootDesc.xml。 - 添加完成后,使用新建的 media_player 实体播放媒体。
如果 Home Assistant 运行在 Docker 中,能播放但暂停/音量状态不更新,请确认 Home Assistant 的 Internal URL 使用宿主机局域网 IP,并为 DLNA GENA 回调发布端口。
14.3 关于 Music Assistant
Music Assistant 可以把 KABU 当作一台普通 AirPlay 或 DLNA 播放器直接投放音乐,无需在 KABU 侧做额外设置;保证 KABU 处于对应模式(白色 AirPlay 或青色 DLNA)、且与 Music Assistant 在同一局域网即可。
15. 固件升级、重启与日常维护
15.1 升级前准备
- 只使用官方发布且明确适用于 KABU 的固件文件。
- 升级方法与注意事项见官网固件升级指引;也可以在USB 在线 OTA页面插线一键完成;历史版本变化见更新说明。
- 确认当前没有播放音乐。
- 使用稳定电源,不要在雷雨、停电风险或电压不稳时升级。
- 让手机/电脑和 KABU 保持稳定网络连接。
- 记下当前固件版本,以便核对。
15.2 Web OTA 升级步骤
- 打开管理首页。
- 滚动到"固件升级"。
- 确认当前固件版本。
- 点击选择文件,选择官方固件文件(如 kabu_ota_v1.9.9.bin)。
- 点击"上传并安装"。
- 等待上传进度和"校验安装中"提示。
- 页面提示成功后,设备会自动重启。
- 等待约 20~60 秒,再刷新管理页确认新版本。
升级时如果提示"播放中无法升级",请在手机、DLNA App 或电台页面停止播放后再试。
15.3 双槽与回滚保护
设备使用两个固件槽。新固件先写入未运行的槽位,成功后再重启进入新版本;如果新版本连续启动失败,系统会回退到可用版本,降低升级失败导致设备无法使用的风险。
15.4 重启设备
可以在管理首页"系统信息"区域点击"重启设备"。重启不会删除 Wi-Fi、名称、EQ、灯光或音量设置。
15.5 恢复出厂状态
需要彻底重置(如转卖设备)时,使用官网的 设备重置 工具:插上 USB 数据线,页面会先诊断设备,确认后清空全部用户数据(Wi-Fi、名称、音量、EQ 与用户数据区),设备随即回到未配网的全新出厂状态并重新进入配网模式。清除后无法恢复;固件、bootloader 与分区表保持不变。
15.6 日常维护建议
- 保持设备通风,避免积灰堵塞周边散热空间。
- 路由器更换后及时重新配网。
- 多台设备使用唯一名称,并在路由器中保留固定 IP。
- 出现网络告警时优先改善 Wi-Fi,不要先大幅调整音频参数。
- 只有在官方明确需要时才打开系统日志并提供给支持人员。
16. 常见问题与故障排除
16.1 通用排查顺序
遇到"没有声音"或不确定哪里出问题时,先用两步定位法分清是音响链路还是网络问题——每台 KABU 都能自己做这两步测试,不需要任何工具:
第一步:双击按键,听有没有播报声。
双击切换模式时,设备会用语音播报新的模式名称,这条声音直接从设备经音频线送到音响:
- 有播报声:设备本体、音频线、功放/音箱整条链路都是通的,问题出在网络或手机投送环节,继续第二步。
- 没有播报声:问题在音响链路。挨个检查——功放/音箱是否开机、音量是否为 0、输入源是否选对(AUX)、音频线是否插在 KABU 的音频输出口、KABU 电源是否正常(待机灯是否亮)。处理后再次双击测试。
第二步:双击切到电台模式(琥珀色),听电台有没有声音。
网络电台直接从互联网收流,电台能出声说明设备已经连上家里的 Wi-Fi 并且外网正常:
- 电台有声:设备、音响、网络全部正常,问题只在手机投送环节——确认手机和 KABU 在同一个 Wi-Fi,播放列表里是否真的选中了这台 KABU(区分设备名)。
- 电台无声(但有播报声):网络问题。按 16.4 检查 Wi-Fi 连接,按 16.10 排查电台播放。
两步做完后再按以下顺序继续排查:
- 看 LED:当前是哪个模式,有没有红色或橙色告警。
- 看音量:手机、KABU、功放/音箱三处都不能为 0 或静音。
- 打开管理页,确认设备在线、固件为 1.9.9。
- 停止播放后重启 KABU,再重试一次。
16.2 找不到 KABU-XXXX 热点
- 长按按钮约 2 秒,等待紫色呼吸灯。
- 在手机 Wi-Fi 页面关闭再打开 Wi-Fi,重新扫描。
- 靠近设备,避免距离太远。
- 如果热点刚因无人连接超过 10 分钟自动关闭,重新长按开启。
- 仍然没有热点且 LED 红闪时,重启设备并联系支持。
16.3 连接热点后配网页面不弹出
- 保持连接 KABU-XXXX,不要切回移动数据或其他 Wi-Fi。
- 关闭手机的"自动切换到蜂窝网络"或类似功能。
- 在浏览器地址栏手动输入
http://192.168.4.1,不要输入 https。 - 如使用 VPN/代理,暂时关闭后再试。
16.4 无法连接家庭 Wi-Fi
- 确认选择的是 2.4 GHz 网络。
- 重新输入密码,注意大小写和空格;v1.9.9 起密码输错会在页面上直接提示,改对重试即可,不会把设备"锁死"。
- 将 KABU 靠近路由器。
- 暂时不要使用隐藏 SSID、企业认证或访客隔离网络。
- 路由器若只允许 WPA3,可开启 WPA2/WPA3 兼容模式后再试。
- 反复失败时,用 USB 线打开官网的「网络唤醒 · 一键清除网络配置」页面清掉错误配置重来。
16.5 管理页面突然打不开
- KABU 的 DHCP IP 可能发生变化,请到路由器客户端列表重新查找。
- 确认手机仍在家庭局域网,而不是蜂窝网络或访客 Wi-Fi。
- 使用
http://而不是https://。 - 为 KABU 设置路由器固定租约,避免以后再次变化。
16.6 AirPlay 列表没有 KABU
- 确认设备是 AirPlay 模式(白色待机灯);DLNA 或电台模式下不会出现在 AirPlay 列表。
- 确认手机和 KABU 在同一局域网。
- 关闭 AP 隔离和组播/mDNS 过滤。
- 重新打开手机 Wi-Fi 或 AirPlay 面板。
- 重启 KABU 和路由器。
16.7 DLNA App 找不到 KABU
- 确认设备处于青色 DLNA 模式。
- 确认 App 支持"DLNA Renderer/播放到设备",不仅仅是浏览媒体库。
- 关闭路由器的 UPnP/组播隔离和访客网络隔离。
- 在 App 中刷新渲染器列表。
- Home Assistant 可直接使用
http://<设备IP>:49152/rootDesc.xml手动添加。
16.8 投送成功但没有声音
- 先按 16.1 的两步定位法判断:双击有播报声说明音响链路正常,问题在手机或网络;连播报声都没有就先检查功放、音频线和三处音量。
- 检查功放/有源音箱输入是否正确(AUX)。
- 检查手机、KABU 和功放三处音量。
- 确认睡眠定时器没有刚到期。
- 确认音频线插在 KABU 的音频输出口,而不是其他接口。
- 换一首常见 MP3/AAC/FLAC/WAV 音频排除格式问题。
- 都正常时重启 KABU 再投一次。
16.9 播放断断续续或出现橙色三连闪
- 将 KABU 靠近路由器或 Mesh 节点。
- 避免把设备放在金属柜、功放电源或强干扰设备旁边。
- 路由器 2.4 GHz 可尝试固定在 1、6 或 11 信道,优先选择较空闲的信道。
- 减少同一 2.4 GHz 网络上的大流量传输。
- 打开
/speedtest查看局域网延迟和抖动。 - Mesh 环境可尝试无缝漫游;单路由器不要开启。
16.10 网络电台无法播放
- 点击"重试"。
- 检查页面错误提示是网络、HTTP、格式还是解码问题。
- 确认 URL 是直接音频流,不是网页。
- 尝试另一个已知可用的 MP3/AAC 地址。
- 第三方电台可能有地域限制或已经更换 URL。
16.11 OTA 按钮提示播放中
- 在 AirPlay/DLNA 发送端点击停止,不只是暂停。
- 在电台页面点击"停止"。
- 等待几秒让播放状态释放。
- 再次上传固件。
16.12 Home Assistant 只能播放,状态不更新
- 确认 Home Assistant 的 Internal URL 是宿主机局域网地址,不是 localhost 或 127.0.0.1。
- Docker 环境确认 DLNA GENA 回调端口已发布。
- 检查回调地址能被 KABU 访问。
- 重新加载 DLNA 集成。
16.13 播放中管理页打不开或很慢
- 多房间高负载或设备信号很弱时,网页管理可能出现超时。
- 只要音乐播放正常、LED 无红闪,音频链路就是正常的,可优先改善设备摆位。
- v1.9.8 已修复多房间播放时管理页整体卡死的问题;若仍有偶发超时,请稍后刷新重试。
16.14 红色灯持续闪烁
- 停止播放并重启设备。
- 确认供电稳定、设备通风正常。
- 打开
/logs,筛选"错误",记录故障发生时间。 - 不要随意刷入来源不明的固件;将日志和版本号提供给售后支持。
17. 技术规格与快速参考卡
17.1 规格速览
| 项目 | 规格 |
|---|---|
| 产品类型 | Wi-Fi 全屋音乐基站 |
| 主控 | ESP32-S3-WROOM-1-N16R8,双核 |
| 闪存 / PSRAM | 16 MB Flash / 8 MB PSRAM |
| 无线网络 | 2.4 GHz Wi-Fi,802.11 b/g/n;支持单路由器及同 SSID Mesh/多 AP 网络 |
| 有线网络 | 不提供有线以太网 |
| 播放模式 | AirPlay、网络电台、DLNA |
| 蓝牙音频 | 不支持 |
| 音频 DAC | PCM5102A I2S DAC(正式硬件配置) |
| 系统输出采样率 | 标准模式 48 kHz;DLNA 高品质模式可按兼容源采样率 44.1~192 kHz 输出 |
| DLNA 常见格式 | MP3、AAC、FLAC、WAV/PCM;24-bit FLAC 高品质直通限双声道 |
| 网络电台 | MP3、AAC、兼容 HLS;最多 200 个电台 |
| 均衡器 | 15 段图示 EQ + 8 段参数 EQ,内置多种预设 |
| 灯光 | 2 颗 RGB LED,KABU Aura / VU 可选 |
| 智能家居 | MQTT / Home Assistant 自动发现 |
| 管理方式 | 中英文 Web 设备门户 |
| 固件升级 | Web OTA 与 USB 直刷,双槽与回滚保护 |
17.2 按钮速查
| 手势 | 功能 |
|---|---|
| 单击 | AirPlay 播放控制;电台下一台;DLNA 切换标准/高品质 |
| 双击 | AirPlay → 电台 → DLNA 循环切换 |
| 长按 2 秒 | 开启配网热点(无人连接约 10 分钟自动关闭) |
17.3 地址速查
| 用途 | 地址 |
|---|---|
| 图文快速上手 | /docs/quick-start.html |
| 首次配网 | http://192.168.4.1 |
| 设置首页 | http://<设备IP>/ |
| 均衡器 | http://<设备IP>/eq |
| 网络电台 | http://<设备IP>/radio |
| 系统日志 | http://<设备IP>/logs |
| Wi-Fi 测速 | http://<设备IP>/speedtest |
| Home Assistant DLNA 描述 | http://<设备IP>:49152/rootDesc.xml |
17.4 模式速查
| 模式 | 颜色 | 最适合 |
|---|---|---|
| AirPlay | 白色 | iPhone、iPad、Mac |
| 网络电台 | 琥珀色 | 不依赖手机的广播收听 |
| DLNA | 青色 | Android、Windows、NAS、Home Assistant |
KABU 全屋音乐基站 — 让音乐自然地流淌在每一个房间。