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 的播放 App選擇 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 管理:無需安裝專用 App,手機瀏覽器即可配置網路、裝置名、燈光和韌體。
- 智慧家庭:支援 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 建議的關機順序
- 先停止手機或播放 App中的音樂。
- 將擴大機或喇叭音量調低。
- 再關閉 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 作為"數位媒體渲染器"出現,播放 App 負責把音訊位址傳送給它。
11.1 Android 手機
- 雙擊按鈕,直到裝置進入 DLNA 模式,燈光為青色。
- 開啟支援 DLNA/UPnP Renderer 的播放 App,例如 BubbleUPnP 等。
- 在 App 中開啟"播放到""渲染器"或"投放裝置"。
- 選擇 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 全屋音樂基站 — 讓音樂自然地流淌在每一個房間。