KABU 使用指南

USER MANUAL

KABU 全屋音乐基站用户使用说明书

适用固件：v1.9.2 正式版 文档版本：1.0 更新日期：2026 年 8 月 27 日

本说明书面向第一次接触 KABU 的普通用户。建议先阅读“快速开始”，完成联网和第一次播放；需要使用多房间、2.1 声场、Home Assistant 或固件升级时，再阅读对应章节。

快速开始：10 分钟听到第一首歌

第 1 步：连接设备

  1. 先将 KABU 的音频输出连接到功放、有源音箱或对应的音频系统。
  2. 将功放或音箱音量先调低，避免第一次播放时音量过大。
  3. 使用产品规定的电源适配器为 KABU 供电，设备会自动启动。

第 2 步：让 KABU 连上家里的 Wi-Fi

  1. 第一次开机时，KABU 会创建一个名为 KABU-XXXX 的临时热点，其中 XXXX 是四位设备编号。
  2. 用手机或电脑连接这个热点。热点默认不需要密码；如果系统提示“此网络无法访问互联网”，请选择继续连接。
  3. 配网页面通常会自动弹出。如果没有弹出，请在浏览器中输入 http://192.168.4.1。
  4. 点击“更改 Wi-Fi 网络”或“扫描网络”，选择家里的 2.4 GHz Wi-Fi，输入密码后点击“连接”。
  5. 手机会与 KABU 热点断开，这是正常现象。让手机重新连接家里的 Wi-Fi，等待 KABU 完成联网。

第 3 步：第一次播放

最省事的方式是使用 AirPlay：

  1. 确认 KABU 处于 AirPlay 模式，待机时灯光为白色慢呼吸。
  2. 在 iPhone 或 iPad 打开“控制中心”，点击播放卡片上的 AirPlay 图标。
  3. 选择 KABU，再播放音乐。
  4. 从较低音量开始，确认声音正常后再逐步调高。

如果使用 Android 或 Windows，请双击设备按钮切到 DLNA 模式，再用支持 DLNA/UPnP 的播放应用选择 KABU。

第 4 步：建议马上完成的两个设置

  1. 在路由器的客户端列表中找到 KABU 的 IP 地址，然后在浏览器打开 http://<设备IP>。
  2. 将设备名称改成容易辨认的名字，例如“客厅 KABU”或“书房 KABU”。如果有多台设备，每台都应使用不同名称。
  3. 在“系统信息”中确认固件版本为 1.9.2。

内容导航

  1. 产品简介与 v1.9.2 重点功能
  2. 使用前准备与安全提醒
  3. 认识设备
  4. 首次联网与更换 Wi-Fi
  5. 按钮操作
  6. LED 灯光说明
  7. 四种播放模式怎么选
  8. AirPlay 使用方法
  9. 网络电台使用方法
  10. DLNA 使用方法
  11. KabuSync 全屋同步使用方法
  12. v1.9.2 的 2.1 声场设置
  13. Web 管理页面完整说明
  14. 音效、灯光、睡眠定时和漫游
  15. Home Assistant 与 Music Assistant
  16. 固件升级、重启与日常维护
  17. 常见问题与故障排除
  18. 技术规格与快速参考卡

1. 产品简介与 v1.9.2 重点功能

KABU 是一款通过 Wi-Fi 接收音频的全屋音乐基站。它可以接收 Apple 设备的 AirPlay 音频，也可以播放网络电台、接收 DLNA 推送，还可以让多台 KABU 通过 KabuSync 同步播放。

1.1 主要功能

KABU 正式产品不提供蓝牙音频播放。手机能搜索到蓝牙设备并不代表 KABU 支持蓝牙投音，请使用 AirPlay、DLNA、网络电台或 KabuSync。

1.2 v1.9.2 的重点变化

v1.9.2 正式加入了“声道角色”设置。每台设备都可以选择：

在 KabuSync 群组中，将三台设备分别设置为左、右、低音炮，即可组成 2.1 声场。低音炮声道会把左右声道合成为单声道，并进行约 120 Hz 的低通处理。

v1.9.2 同时加强了 DLNA 和 KabuSync 的长时间运行、重组和自愈稳定性。对普通用户来说，最直接的变化是：多台设备频繁暂停、切歌、换组长或重新入组后，更容易自动恢复到正常状态。

2. 使用前准备与安全提醒

2.1 开箱后请先确认

不同销售套装所附配件可能不同，请以包装清单为准。开始使用前至少需要：

2.2 安全提醒

2.3 网络要求

3. 认识设备

3.1 常用部件

部件用途
电源接口连接产品规定的电源适配器
音频输出连接功放、有源音箱或对应音频系统；接口外观以实际机型为准
多功能按钮单击、双击、三击和长按分别执行不同操作
RGB 指示灯显示启动、联网、模式、播放、按键和故障状态

3.2 建议的开机顺序

  1. 先连接音频线。
  2. 把功放或音箱音量调低。
  3. 给 KABU 供电。
  4. 等待 KABU 完成联网并进入待机。
  5. 开始播放后，再逐步调到合适音量。

3.3 建议的关机顺序

  1. 先停止手机或播放应用中的音乐。
  2. 将功放或音箱音量调低。
  3. 再关闭 KABU 或音频系统电源。

4. 首次联网与更换 Wi-Fi

4.1 第一次开机配网

设备没有保存 Wi-Fi 信息时，会自动开启配网热点。

  1. 等待 LED 由启动灯效进入紫色慢呼吸。
  2. 打开手机“设置 → Wi-Fi”。
  3. 连接 KABU-XXXX。XXXX 为设备 Wi-Fi 地址末尾四位，因此每台设备都不同。
  4. 如果手机提示“无互联网连接”，请选择“保持连接”或“仍然使用此网络”。
  5. 等待配网页面自动出现；没有出现时，手动打开 http://192.168.4.1。
  6. 点击“更改 Wi-Fi 网络”，再点击“扫描网络”。
  7. 选择家里的 2.4 GHz Wi-Fi，输入密码，点击“连接”。
  8. 页面提示已保存并重启后，等待约 20～30 秒。
  9. 手机重新连接家庭 Wi-Fi。

4.2 找到设备的管理地址

联网成功后，KABU 会从路由器获得一个局域网 IP 地址。推荐使用以下方法查找：

  1. 打开路由器管理页面或路由器 App。
  2. 进入“已连接设备”“终端管理”或类似页面。
  3. 查找名称为 KABU 的设备并记录 IP，例如 192.168.1.67。
  4. 在浏览器输入 http://192.168.1.67。

iPhone 或 Mac 在部分网络中也可以尝试访问 http://kabu.local。如果打不开，请使用路由器显示的 IP 地址。

建议在路由器中为每台 KABU 设置“固定租约”或“地址保留”。这样 IP 不容易变化，以后打开管理页面更方便。

4.3 更换路由器或 Wi-Fi 密码

如果旧 Wi-Fi 仍然可用：

  1. 打开 KABU 管理首页。
  2. 在“Wi-Fi 网络”区域点击“更改 Wi-Fi 网络”。
  3. 扫描并选择新网络，输入新密码。
  4. 点击“连接”，等待设备重启。

如果旧 Wi-Fi 已经不可用：

  1. 长按设备按钮约 2 秒。
  2. 等待紫色配网灯效出现。
  3. 连接 KABU-XXXX 热点。
  4. 打开 http://192.168.4.1，重新配置网络。

4.4 临时热点会自动关闭

长按按钮开启的是临时配网热点。无人连接时，它会在约 10 分钟后自动关闭；也可以再次长按约 2 秒手动关闭。关闭热点不会删除已经保存的家庭 Wi-Fi 信息。

5. 按钮操作

KABU 只有一个按钮，但可以识别四种手势。按键完成后，LED 会用闪烁次数进行确认。

操作怎么按作用
单击快速按 1 次根据当前模式执行播放、暂停或下一电台
双击连续快速按 2 次普通模式间循环；在 KabuSync 中返回上次普通模式
三击连续快速按 3 次从普通模式进入 KabuSync；设备会受控重启
长按按住约 2 秒开启或关闭临时配网热点

5.1 单击在不同模式中的作用

当前模式单击作用
AirPlay尝试播放/暂停；如果当前 App 不接受远程控制，请在手机端操作
网络电台切换到下一个电台并播放
DLNA暂停或继续当前推送
KabuSync对当前接收投送的设备执行暂停/继续；群组控制建议优先使用推送 App

5.2 双击的模式顺序

在普通模式中，双击只在以下三个模式间循环：

AirPlay → 网络电台 → DLNA → AirPlay

这三个模式之间采用热切换，通常几秒内完成，不需要整机重启。

在 KabuSync 模式中双击，设备会退出 KabuSync，回到进入 KabuSync 前最近使用的普通模式。由于运行资源不同，进出 KabuSync 会执行一次受控重启。

5.3 三击进入 KabuSync

三击后会看到三次白色按键反馈，设备播报/重启并进入紫色的 KabuSync 模式。正常情况下约 15 秒后可用；如果多台设备同时刚上电，建议等待最多 1 分钟再开始第一次投送。

5.4 长按配网

按住按钮时会显示琥珀色提示。约 2 秒后松开，设备会开启或关闭 KABU-XXXX 临时热点。

6. LED 灯光说明

6.1 模式颜色

模式代表颜色
AirPlay白色
网络电台琥珀色
DLNA青色
KabuSync紫色

6.2 系统状态和灯效

LED 表现含义用户该做什么
白色启动渐变正在开机等待启动完成
橙色呼吸正在连接家庭 Wi-Fi等待；长时间不消失时检查 Wi-Fi
紫色慢呼吸配网热点已开启连接 KABU-XXXX 并打开 192.168.4.1
模式颜色慢呼吸网络正常，当前处于待机可以开始投送
模式颜色低亮常亮已连接音源但处于暂停在 App 或设备上继续播放
KABU Aura 氛围光正在播放正常状态
随音乐跳动的 VU 灯效正在播放，已选择“音乐律动”正常状态
橙色三连闪，每约 3 秒出现一次网络拥塞或丢包风险上升靠近路由器、减少干扰或更换信道
红色闪烁设备检测到错误重启一次；仍出现时查看日志或联系支持

播放时的 KABU Aura 会使用所选氛围色调，不一定一直显示当前模式色。待机和暂停时，模式颜色最容易识别。

6.3 按键反馈

6.4 调整灯光

在管理首页的“设备”区域可以：

这些设置会保存，重启后继续使用。

7. 四种播放模式怎么选

你的设备或目的推荐模式原因
iPhone、iPad、Mac 日常听歌AirPlay系统原生支持，操作最简单
听固定网络广播网络电台不需要手机一直推送
Android、Windows、NAS 或通用播放器DLNA兼容面广，适合“投放到设备”
多台 KABU 全屋同时播放KabuSync最多 5 台同步，支持 DLNA 音源
三台设备组成左、右、低音炮KabuSync + 2.1 声道角色v1.9.2 专用声场功能
多台 AirPlay 音箱一起播放AirPlay 2 分组由 Apple 设备直接分组控制

7.1 模式互斥

同一台 KABU 同一时间只运行一种播放模式。处于 KabuSync 时，该设备不会出现在 AirPlay 列表；处于 AirPlay 时，也不会作为 KabuSync 成员播放。

7.2 开机恢复

设备会恢复上一次成功进入的模式。若某个模式连续启动失败，设备会采用安全回退，重新进入 AirPlay，避免一直卡在不可用状态。

8. AirPlay 使用方法

8.1 iPhone 或 iPad

  1. 确认手机与 KABU 在同一局域网。
  2. 将 KABU 切换到 AirPlay 模式，待机灯光为白色慢呼吸。
  3. 从屏幕右上角向下滑，打开“控制中心”。
  4. 在播放卡片中点击 AirPlay 图标。
  5. 选择 KABU 或你设置的房间名称。
  6. 播放音乐，并从较低音量开始调节。

也可以在 Apple Music、播客或其他支持 AirPlay 的 App 内直接点击 AirPlay 图标。

8.2 Mac

  1. 点击菜单栏“控制中心”。
  2. 打开“声音”或播放控制。
  3. 在输出设备中选择 KABU。
  4. 也可以在支持 AirPlay 的音乐 App 中单独选择 KABU。

8.3 AirPlay 2 多房间播放

  1. 先让每台设备都进入 AirPlay 模式。
  2. 打开 iPhone/iPad 的 AirPlay 面板。
  3. 同时勾选多台 KABU 或其他 AirPlay 2 音箱。
  4. 使用 AirPlay 面板统一调整播放和音量。
音量安全提醒：后加入 AirPlay 2 群组的设备，可能短暂使用它上次保存的音量，随后才收到群组音量。分组前请把各房间设备音量调低，再统一增加音量。

8.4 AirPlay 模式的声道规则

无论管理页中的“声道角色”设置成什么，AirPlay 都会保持立体声输出。v1.9.2 的左/右/低音炮角色只用于 KabuSync 群组等非 AirPlay 播放路径。

8.5 AirPlay 找不到设备时

  1. 确认 KABU 是白色模式色，不是青色或紫色。
  2. 确认手机与 KABU 在同一局域网。
  3. 关闭路由器的 AP/客户端隔离。
  4. 在 AirPlay 面板下拉刷新，或关闭再打开 Wi-Fi。
  5. 重启 KABU 和路由器后再试。

9. 网络电台使用方法

9.1 进入电台模式

在 AirPlay 模式下双击一次，设备会播报“电台模式”，灯光变为琥珀色，并尝试继续播放上次收听的电台；如果没有历史记录，则使用第一个可用电台。

9.2 用按钮听电台

9.3 打开电台页面

在浏览器打开：

http://<设备IP>/radio

页面从上到下包括：当前电台、节目/音频信息、连接状态、上一台/停止/下一台/重试、音量、电台列表和手动添加区域。

9.4 播放与切换

  1. 在电台列表中找到想听的电台。
  2. 点击右侧播放按钮。
  3. 状态会依次显示“正在连接”“缓冲中”“正在播放”。
  4. 如遇暂时性错误，点击“重试”。
  5. 点击“停止”即可结束播放。

9.5 内置电台

v1.9.2 出厂列表包含以下 6 个电台：

  1. 清晨音乐台
  2. 中国之声
  3. 上海新闻广播
  4. 第一财经
  5. 深圳新闻广播
  6. 音乐之声

网络电台地址由第三方提供，可能因运营方调整、地域限制或临时维护而失效。这不一定代表 KABU 出现故障。

9.6 添加自己的电台

  1. 在电台页面底部输入电台名称。
  2. 粘贴直接音频流地址，必须以 http:// 或 https:// 开头。
  3. 点击“添加电台”。
  4. 添加成功后，新电台会出现在列表底部。

可以使用常见的 MP3、AAC 和兼容 HLS 直播流。普通网页地址、需要登录的页面、RTMP、RTSP、加密 HLS、fMP4 HLS 或非音频链接通常无法播放。

9.7 删除与容量

9.8 电台音量

电台页面的音量滑块范围为 0%～100%。设备会记住电台音量，重启或下次回到电台模式时继续使用。

10. DLNA 使用方法

DLNA 适合 Android、Windows、NAS、Home Assistant 以及支持 UPnP/DLNA 的播放器。KABU 作为“数字媒体渲染器”出现，播放应用负责把音频地址发送给它。

10.1 Android 手机

  1. 双击按钮，直到设备进入 DLNA 模式，灯光为青色。
  2. 打开支持 DLNA/UPnP Renderer 的播放应用，例如 BubbleUPnP 等。
  3. 在应用中打开“播放到”“渲染器”或“投放设备”。
  4. 选择 KABU 或你设置的房间名称。
  5. 选择音乐并播放。

不同 App 的菜单名称不同，但核心步骤都是：先选择 KABU 作为播放设备，再选择音乐。

10.2 Windows 电脑

可使用支持“投放到设备”或 UPnP Renderer 的播放器：

  1. 确认电脑与 KABU 在同一局域网。
  2. 让 KABU 进入 DLNA 模式。
  3. 在播放器中找到“Cast to device”“Play to”“Renderer”或类似菜单。
  4. 选择 KABU 后开始播放。

10.3 支持的常见音频

DLNA 播放路径支持常见的 MP3、AAC、FLAC、WAV/PCM 音频。能否播放还取决于发送端给出的媒体地址、封装、采样参数和网络访问权限。

10.4 播放控制与音量

10.5 普通 DLNA 与 KabuSync 的区别

11. KabuSync 全屋同步使用方法

KabuSync 是 KABU 的全屋同步模式，底层使用 Sendspin 技术。日常界面统一显示“KabuSync”；在 Music Assistant 或部分高级状态中看到 sendspin，指的就是同一模式。

11.1 使用条件

11.2 方法一：逐台三击进入

  1. 在每台 KABU 上连续按三次按钮。
  2. 等待每台设备重启并显示紫色模式色。
  3. 多台设备同时刚启动时，等待约 15 秒；首次组建较慢时可等待最多 1 分钟。

11.3 方法二：网页一键切换

  1. 打开任意一台 KABU 的管理首页。
  2. 点击“全屋模式”。
  3. 确认列表中显示了要使用的 KABU。
  4. 点击“全部切换为 KabuSync”。
  5. 确认操作，等待各设备重启。
  6. 约 15 秒后点击“刷新”查看模式。

如果没有发现其他设备，请确认它们已开机、在同一 Wi-Fi，并关闭路由器的设备隔离功能。

11.4 开始全屋播放

  1. 打开支持 DLNA 的手机或电脑播放应用。
  2. 在设备列表中选择任意一台处于 KabuSync 的 KABU。
  3. 选择音乐并播放。
  4. 被投送的设备会接管这次播放，其他 KabuSync 设备自动加入并同步出声。

第一次播放或刚发生设备上下线时，起播可能需要几秒；群组稳定后，后续暂停再播放通常会更快。

11.5 群组规则

11.6 群组音量

在 KabuSync 活跃播放时，使用 DLNA 发送端的音量控制可同步调整整个群组。建议从较低音量开始，尤其是多个房间或低音炮同时开启时。

11.7 退出 KabuSync

进出 KabuSync 会重启设备，属于正常现象。

12. v1.9.2 的 2.1 声场设置

12.1 2.1 是什么

2.1 声场通常由三路组成：

KABU v1.9.2 可以让三台设备分别承担这三个角色，同时继续使用 KabuSync 的统一时间轴，因此左右和低音保持同步。

12.2 准备工作

  1. 准备 3 台 KABU 以及对应的功放/音箱。
  2. 将三台设备命名为容易辨认的名称，例如“客厅左”“客厅右”“客厅低音”。
  3. 将左右音箱摆放在听音位置左右两侧，低音炮放在合适位置。
  4. 把三路功放音量先调低并保持大致一致。

12.3 设置每台设备的声道角色

在三台设备上分别操作：

  1. 打开该设备的管理首页 http://<设备IP>。
  2. 找到“声场模式”。
  3. 左侧设备选择“左声道”，点击“保存声场模式”。
  4. 右侧设备选择“右声道”，点击保存。
  5. 连接低音炮的设备选择“低音炮”，点击保存。
  6. 保存后再次查看选项，确认每台设备的角色正确。

声道角色会持久保存，设备重启后仍然有效。

12.4 进入 KabuSync 并播放

  1. 在“全屋模式”页面点击“全部切换为 KabuSync”，或逐台三击。
  2. 等待三台设备完成重启和组建。
  3. 用 DLNA 播放应用向其中任意一台 KABU 投送一首左右声道差异明显、低频清楚的测试音乐。
  4. 从低音量开始播放。
  5. 靠近每个音箱确认：左侧主要播放左声道，右侧主要播放右声道，低音炮主要播放低频。

12.5 低音炮声道说明

低音炮角色会将左右声道求和为单声道，再进行约 120 Hz 的二阶低通处理。它不是完整频段的“立体声复制”，因此听起来只有低频是正常现象。

12.6 常用组合

使用场景建议角色
三个房间分别独立听全频音乐三台都选“立体声”
两台组成左右声道一台“左声道” + 一台“右声道”
三台组成 2.1“左声道” + “右声道” + “低音炮”

12.7 重要限制

13. Web 管理页面完整说明

13.1 访问地址

管理首页地址是：

http://<设备IP>

常用子页面：

页面地址主要用途
设置首页/网络、声场、MQTT、设备、灯光、睡眠、OTA、系统信息
专业均衡器/eq15 段图示 EQ、8 段参数 EQ
网络电台/radio播放、添加、删除电台和调音量
全屋模式/lan查看局域网 KABU，并全部切换 KabuSync/AirPlay
系统日志/logs实时查看运行日志，供故障排查
Wi-Fi 测速/speedtest测试浏览器与 KABU 之间的局域网延迟和吞吐量

13.2 Wi-Fi 网络

单路由器家庭保持默认即可（仅单节点时不会触发漫游，无副作用）。若你的家庭使用 Mesh 组网，建议阅读 14.6 节。

13.3 功能入口

首页的“功能”区域提供均衡器、电台、全屋模式、系统日志和 Wi-Fi 测速入口。均衡器入口只在当前固件功能可用时显示。

13.4 声场模式

用于选择立体声、左声道、右声道或低音炮。设置后应看到“已保存并生效”。详细方法见第 12 章。

13.5 MQTT / 智能家居

可以启用 MQTT，填写 Broker 地址、用户名和密码。Broker 地址必须以 mqtt:// 开头，例如：

mqtt://192.168.1.10:1883

13.6 设备

可修改以下内容：

设备名称保存后需要重启才会完整应用到 AirPlay、DLNA 和网络广播名称。

13.7 固件升级

显示当前固件版本、运行分区，并允许选择 firmware.bin 上传安装。播放中会拒绝升级，需先停止音乐。

13.8 系统信息

可查看 IP、MAC、设备名称、固件版本、Wi-Fi 名称、信号强度、信道和 PHY 信息。页面底部的“重启设备”会要求再次确认。

13.9 语言

页面支持中文和 English。语言选择保存在当前浏览器中，不会改变设备语音提示。

13.10 Wi-Fi 测速的正确理解

测速页测量的是手机/电脑浏览器与 KABU 之间的局域网连接，不是运营商互联网速度。它适合判断 KABU 所在位置的 Wi-Fi 延迟、抖动和吞吐是否稳定。

14. 音效、灯光、睡眠定时和漫游

14.1 普通用户如何调 EQ

  1. 打开 http://<设备IP>/eq。
  2. 确认“启用均衡器”已开启。
  3. 初次使用建议选择“15 段图示”。
  4. 从“温暖”“清晰”“轻微 V 形”“人声”预设中选择最接近需求的一项。
  5. 每次只小幅调整 0.5～2 dB，再实机试听。
  6. 点击“安全应用”。

图示均衡器提供 15 个频段，范围为 -15 dB～+15 dB。页面会计算组合峰值，并自动保留 0.5 dB 安全余量。

14.2 参数 EQ 适合谁

“8 段参数”适合熟悉频率、增益和 Q 值的用户。可选择峰值、低架、高架、高通和低通等滤波器。建议普通用户优先使用图示 EQ 和保守预设，避免大幅提升多个相邻频段。

14.3 前级和失真

手动前级只允许衰减。大量提升 EQ 频段可能导致系统自动降低总体增益，这是为了避免数字削波，并不是设备音量故障。

14.4 睡眠定时器

管理首页提供以下选项：关闭、15、30、60、90 和 120 分钟。

  1. 选择时间后立即开始倒计时。
  2. 页面会显示剩余时间。
  3. 重新选择时间会替换原倒计时。
  4. 选择“关闭”可取消。

到时后，电台会暂停，DLNA/KabuSync 会暂停。AirPlay 会尝试通知音源暂停；如果音源不接受控制，KABU 会在本地保证静音。高级 MQTT 命令最多可设置 720 分钟。

14.5 无缝漫游

无缝漫游用于同一个 SSID 下有多个 Mesh 节点或 AP 的环境。它会在不主动打断播放的前提下寻找更合适的节点。

建议：

14.6 Mesh 组网环境（v1.9.6 起重点支持）

KABU 在家用 Mesh 路由组网（如小米、TP-Link、华为等品牌的 Mesh 套装，所有节点同一网络名、带外网）下，AirPlay、DLNA、网络电台、网页管理、OTA 升级和 MQTT 均可正常使用。

推荐设置：

  1. v1.9.6 起无缝漫游默认开启，无需手动操作。可在设置首页确认“无缝漫游 (802.11k/v/r)”开关处于开启状态；点击“扫描网络”时，若设备检测到同一网络名下有多个 AP，也会给出确认提示。
  2. 开启后的行为：
  1. 尽量让手机/音源与 KABU 连在同一个网络名下（Mesh 默认即如此）。

已知限制与排障：

诊断：浏览器访问 http://<设备IP>/api/wifi/status 可查看当前连接的节点（BSSID）、信号、信道、AP 是否支持 802.11k/v、漫游开关与最近漫游事件、AirPlay/DLNA 广播状态，用于 Mesh 环境问题定位。

15. Home Assistant 与 Music Assistant

这一章属于进阶功能。只使用 AirPlay、网络电台或普通 DLNA 的用户可以跳过。

15.1 通过 MQTT 接入 Home Assistant

准备条件：

操作步骤：

  1. 打开 KABU 管理首页。
  2. 在“MQTT / 智能家居”中开启 MQTT。
  3. 输入 Broker，例如 mqtt://192.168.1.10:1883。
  4. 如 Broker 要求认证，填写用户名和密码。
  5. 点击“保存 MQTT 设置”。
  6. 等待页面显示“已连接”。
  7. 在 Home Assistant 的“设置 → 设备与服务 → MQTT”中查找 KABU。

自动发现后，通常会出现状态、音源、Wi-Fi 信号、音量、静音、模式、播放/暂停、上一首/下一首、电台名称、媒体信息和网络健康等实体。

Home Assistant 的模式选项中可能显示 sendspin。这是 KabuSync 的底层名称，选择它等同于切换到 KabuSync，并会触发受控重启。

15.2 通过 Home Assistant 的 DLNA 集成播放

  1. 先让 KABU 进入 DLNA 模式。
  2. 在 Home Assistant 打开“设置 → 设备与服务 → 添加集成”。
  3. 搜索 DLNA Digital Media Renderer。
  4. 如果没有自动发现，手动输入：

http://<设备IP>:49152/rootDesc.xml

  1. 添加完成后，使用新建的 media_player 实体播放媒体。

如果 Home Assistant 运行在 Docker 中，能播放但暂停/音量状态不更新，请确认 Home Assistant 的 Internal URL 使用宿主机局域网 IP，并为 DLNA GENA 回调发布端口。v1.9.2 验证环境使用监听端口 14000，回调地址格式为：

http://<Home Assistant 宿主机IP>:14000/notify

15.3 通过 Music Assistant 使用 Sendspin

v1.9.2 可作为 Sendspin 播放器连接 Music Assistant：

  1. 让设备进入 KabuSync 模式。
  2. 在 Music Assistant 的播放器设置中添加 Sendspin 播放器。
  3. 自动发现失败时，手动输入 KABU 的 IP 地址。
  4. 首次连接可能会自动尝试数次，等待约 3～5 秒。
  5. 连接后，在 Music Assistant 中选择播放器、音乐和音量。

v1.9.2 发布时验证的组合是 Music Assistant 2.9.13 与其捆绑的 aiosendspin 6.0.5。其他版本的界面和兼容情况可能不同。

16. 固件升级、重启与日常维护

16.1 升级前准备

  1. 只使用官方发布且明确适用于 KABU 的 firmware.bin。
  2. 确认当前没有播放音乐。
  3. 使用稳定电源，不要在雷雨、停电风险或电压不稳时升级。
  4. 让手机/电脑和 KABU 保持稳定网络连接。
  5. 记下当前固件版本，以便核对。

16.2 Web OTA 升级步骤

  1. 打开管理首页。
  2. 滚动到“固件升级”。
  3. 确认当前固件版本。
  4. 点击选择文件，选择官方 firmware.bin。
  5. 点击“上传并安装”。
  6. 等待上传进度和“校验安装中”提示。
  7. 页面提示成功后，设备会自动重启。
  8. 等待约 20～60 秒，再刷新管理页确认新版本。

升级时如果提示“播放中无法升级”，请在手机、DLNA App 或电台页面停止播放后再试。

16.3 双槽与回滚保护

设备使用两个固件槽。新固件先写入未运行的槽位，成功后再重启进入新版本；如果新版本连续启动失败，系统会回退到可用模式，降低升级失败导致设备无法使用的风险。

16.4 重启设备

可以在管理首页“系统信息”区域点击“重启设备”。重启不会删除 Wi-Fi、名称、EQ、灯光、音量或声道角色。

16.5 恢复出厂状态

v1.9.2 没有面向用户的一键“恢复出厂设置”按钮。需要彻底清除 Wi-Fi 和个性化设置时，请联系售后或使用官方提供的 USB 工厂重刷流程。工厂重刷可能清除全部设置，请提前确认。

16.6 日常维护建议

17. 常见问题与故障排除

17.1 通用排查顺序

遇到问题时，按以下顺序通常最快：

  1. 看 LED：当前是哪个模式，有没有红色或橙色告警。
  2. 看音源：手机/电脑是否真的选择了这台 KABU。
  3. 看音量：手机、KABU、功放/音箱三处都不能为 0 或静音。
  4. 看网络：设备与手机是否在同一局域网，是否开启了隔离。
  5. 打开管理页，确认设备在线、固件为 1.9.2。
  6. 停止播放后重启 KABU，再重试一次。

17.2 找不到 KABU-XXXX 热点

  1. 长按按钮约 2 秒，等待紫色呼吸灯。
  2. 在手机 Wi-Fi 页面关闭再打开 Wi-Fi，重新扫描。
  3. 靠近设备，避免距离太远。
  4. 如果热点刚刚无人连接超过 10 分钟，重新长按开启。
  5. 仍然没有热点且 LED 红闪时，重启设备并联系支持。

17.3 连接热点后配网页面不弹出

  1. 保持连接 KABU-XXXX，不要切回移动数据或其他 Wi-Fi。
  2. 关闭手机的“自动切换到蜂窝网络”或类似功能。
  3. 在浏览器地址栏手动输入 http://192.168.4.1，不要输入 https。
  4. 如使用 VPN/代理，暂时关闭后再试。

17.4 无法连接家庭 Wi-Fi

  1. 确认选择的是 2.4 GHz 网络。
  2. 重新输入密码，注意大小写和空格。
  3. 将 KABU 靠近路由器。
  4. 暂时不要使用隐藏 SSID、企业认证或访客隔离网络。
  5. 路由器若只允许 WPA3，可开启 WPA2/WPA3 兼容模式后再试。

17.5 管理页面突然打不开

  1. KABU 的 DHCP IP 可能发生变化，请到路由器客户端列表重新查找。
  2. 确认手机仍在家庭局域网，而不是蜂窝网络或访客 Wi-Fi。
  3. 使用 http:// 而不是 https://。
  4. 为 KABU 设置路由器固定租约，避免以后再次变化。

17.6 AirPlay 列表没有 KABU

  1. 确认设备是 AirPlay 模式（白色），KabuSync 模式不会显示 AirPlay。
  2. 确认手机和 KABU 在同一局域网。
  3. 关闭 AP 隔离和组播/mDNS 过滤。
  4. 重新打开手机 Wi-Fi 或 AirPlay 面板。
  5. 重启 KABU 和路由器。

17.7 DLNA App 找不到 KABU

  1. 确认设备处于青色 DLNA 模式，或处于紫色 KabuSync 模式。
  2. 确认 App 支持“DLNA Renderer/播放到设备”，不仅仅是浏览媒体库。
  3. 关闭路由器的 UPnP/组播隔离和访客网络隔离。
  4. 在 App 中刷新渲染器列表。
  5. Home Assistant 可直接使用 http://<设备IP>:49152/rootDesc.xml 手动添加。

17.8 投送成功但没有声音

  1. 检查功放/有源音箱输入是否正确。
  2. 检查手机、KABU 和功放音量。
  3. 确认睡眠定时器没有刚到期。
  4. 如果设备角色是“低音炮”，请用含明显低频的音乐测试；只有人声时可能很小。
  5. 把声道角色临时改为“立体声”再次测试。
  6. 换一首常见 MP3/AAC/FLAC/WAV 音频，排除格式问题。

17.9 播放断断续续或出现橙色三连闪

  1. 将 KABU 靠近路由器或 Mesh 节点。
  2. 避免把设备放在金属柜、功放电源或强干扰设备旁边。
  3. 路由器 2.4 GHz 可尝试固定在 1、6 或 11 信道，优先选择较空闲的信道。
  4. 减少同一 2.4 GHz 网络上的大流量传输。
  5. 打开 /speedtest 查看局域网延迟和抖动。
  6. Mesh 环境可尝试无缝漫游；单路由器不要开启。

17.10 KabuSync 有设备没有加入

  1. 确认所有设备都是紫色 KabuSync 模式。
  2. 确认所有设备在同一个局域网。
  3. 群组上限是 5 台；超出的设备不会加入本次播放。
  4. 刚刚同时重启多台设备时，等待最多 1 分钟再重试。
  5. 在“全屋模式”页面刷新，确认设备在线和固件版本。
  6. 停止投送，等待几秒后重新向任意一台 KABU 播放。

17.11 2.1 左右声道不对

  1. 分别打开三台设备的管理页，重新确认角色。
  2. 确认设置后出现“已保存并生效”。
  3. 确认播放发生在 KabuSync 中；AirPlay 会强制立体声。
  4. 检查实际音频线是否接到了对应左、右、低音音箱。
  5. 用明确的左右声道测试音源，先低音量逐路检查。

17.12 网络电台无法播放

  1. 点击“重试”。
  2. 检查页面错误提示是网络、HTTP、格式还是解码问题。
  3. 确认 URL 是直接音频流，不是网页。
  4. 尝试另一个已知可用的 MP3/AAC 地址。
  5. 第三方电台可能有地域限制或已经更换 URL。

17.13 OTA 按钮提示播放中

  1. 在 AirPlay/DLNA/KabuSync 发送端点击停止，不只是暂停。
  2. 在电台页面点击“停止”。
  3. 等待几秒让播放状态释放。
  4. 再次上传固件。

17.14 Home Assistant 只能播放，状态不更新

  1. 确认 Home Assistant 的 Internal URL 是宿主机局域网地址，不是 localhost 或 127.0.0.1。
  2. Docker 环境确认 DLNA GENA 回调端口已发布。
  3. 检查回调地址能被 KABU 访问。
  4. 重新加载 DLNA 集成。

17.15 红色灯持续闪烁

  1. 停止播放并重启设备。
  2. 确认供电稳定、设备通风正常。
  3. 打开 /logs，筛选“错误”，记录故障发生时间。
  4. 不要随意刷入来源不明的固件；将日志和版本号提供给售后支持。

18. 技术规格与快速参考卡

18.1 v1.9.2 正式版规格

项目规格
产品类型Wi-Fi 全屋音乐基站
主控ESP32-S3-WROOM-1-N16R8，双核
闪存 / PSRAM16 MB Flash / 8 MB PSRAM
无线网络2.4 GHz Wi-Fi，802.11 b/g/n
有线网络v1.9.2 正式硬件配置不提供有线以太网
播放模式AirPlay、网络电台、DLNA、KabuSync
蓝牙音频不支持
音频 DACPCM5102A I2S DAC（正式硬件配置）
系统输出采样率48 kHz，音源不同时自动转换
DLNA 常见格式MP3、AAC、FLAC、WAV/PCM
网络电台MP3、AAC、兼容 HLS；最多 200 个电台
KabuSync 容量最多 5 台设备
KabuSync 同步实测设备间同步偏差小于 1 ms 的产品目标
2.1 角色立体声、左、右、低音炮；低音炮约 120 Hz 低通
均衡器15 段图示 EQ + 8 段参数 EQ
灯光2 颗 RGB LED，KABU Aura / VU 可选
智能家居MQTT / Home Assistant 自动发现
管理方式中英文 Web 设备门户
固件升级Web OTA，双槽与回滚保护

18.2 按钮速查

手势功能
单击当前模式的播放/暂停或下一电台
双击AirPlay → 电台 → DLNA；KabuSync 中双击退出
三击进入 KabuSync
长按 2 秒开启/关闭配网热点

18.3 地址速查

用途地址
首次配网http://192.168.4.1
设置首页http://<设备IP>/
均衡器http://<设备IP>/eq
网络电台http://<设备IP>/radio
全屋模式http://<设备IP>/lan
系统日志http://<设备IP>/logs
Wi-Fi 测速http://<设备IP>/speedtest
Home Assistant DLNA 描述http://<设备IP>:49152/rootDesc.xml

18.4 模式速查

模式颜色最适合
AirPlay白色iPhone、iPad、Mac
网络电台琥珀色不依赖手机的广播收听
DLNA青色Android、Windows、NAS、Home Assistant
KabuSync紫色2～5 台全屋同步和 2.1 声场

18.5 2.1 最短操作路径

  1. 三台设备分别命名为左、右、低音。
  2. 在三台管理页分别选择左声道、右声道、低音炮并保存。
  3. 在“全屋模式”点击“全部切换为 KabuSync”。
  4. 等待设备完成重启和组建。
  5. 用 DLNA App 向任意一台 KABU 投送。
  6. 从低音量开始确认三路输出。

KABU 全屋音乐基站 — 让音乐自然地流淌在每一个房间。

使用指南固件下载返回首页