功能

各項功能的前提條件與操作被停用的原因，見功能啟用條件。

請先確認閘道器能轉送流量。將範例訂閱與節點換成可用的訂閱與節點，再從實際的區域網路用戶端分別測試直連與代理的 TCP、UDP 及 DNS。honk-core is running、dae0 連結或可存取的 API 都無法證明流量正常。

本頁介紹標準版；doona lite 請參閱 doona lite。

逐項檢查功能

範例組態提供下表功能所需的設定；替換佔位的訂閱與節點後，再逐項檢查實際執行情況。

自動記錄模式下，流程請求、日誌串流與 DNS 記錄讀取各自啟用對應記錄器，並分別有 60 秒寬限期。連線、分流與規則頁開啟時會請求流程。已允許但處於閒置狀態的記錄器屬於正常情況。

仍有功能缺少時

• 變更 native_api 後沒有重新啟動 honk。重載不會套用這些欄位。
• 缺少 config_write: true。native_api 的欄位直接寫在 experimental 下時，honk 會以 unknown experimental setting 拒絕啟動。
• 既沒有 password_auth: true，也沒有 secret，且未啟用匿名 loopback。此時若設定了 enabled: true，honk 會拒絕啟動。listen 為 loopback 位址且設定 allow_anonymous_loopback: true 時，讀取請求無需 Token。組態寫入與受保護的設定變更仍需要憑證。此模式僅用於本機開發。
• 檔案包含密鑰或與密鑰相同的文字，因此 doona 將其顯示為唯讀。
• honk 是早期的 feat/native-api 建置，因此地理資料卡片沒有來源設定。請安裝 doona 發行版本附帶的建置，見 honk 版本。
• Token 模式下狀態資料庫未能開啟，因此地理資料卡片沒有可設定的來源與排程控制項。檔案表格仍會顯示；已設定網址且後端支援更新時，仍可手動更新。詳見狀態資料庫問題。
• 僅在以 --store db 執行時出現，本文件不使用此模式：honk 未能記錄的修訂會阻止後續寫入，直到下一次成功啟用組態。

登入之後

介面指南與操作步驟請參閱文件目錄。

每一次組態來源的寫入都經過引擎。doona 帶著讀取時的雜湊送出（If-Match）；磁碟上已變動的檔案會回傳 412，不會寫入。引擎先驗證整組來源，再儲存並重載；重載失敗時仍沿用先前的世代。預先驗證不會寫入，遮蔽後的文字也不會寫回。執行期設定與群組選擇走各自的端點，各有檢查。

頁面與所需資源

所有頁面都保留在導覽列中。只有 registry.ts 為頁面列出的資源全部不可用時，頁面才會標為不可用；後端提供匯出、匯入或修訂時，組態頁也可用。開啟無法使用的頁面會顯示提示。Ctrl K（macOS 為 ⌘ K）可搜尋頁面與即時資料，也涵蓋設定欄位與動作、持久化 global 設定、組態區段與功能入口；選擇結果會開啟並聚焦控制項，不會執行動作，見搜尋範例。

小工具

活動頁儀表板與浮動面板共用小工具庫。兩處都提供「出站失敗」「節點可用性」「DNS 延遲」與「訂閱額度」。「訂閱額度」不在預設版面中，列出每個訂閱的到期時間與配額計量器；未回報額度時只顯示用量。「來源狀態」在提供方回報額度時也會顯示用量計量器。

記憶體預設使用圖表。選擇「迷你折線圖」可顯示為類似「下載」與「上傳」的數值卡片，儀表板寬度可從一列的五分之一到整列。面板的中型記憶體小工具顯示常駐記憶體及 cgroup 用量與上限，大型才顯示圖表。

記憶體計量器標為「cgroup 已用」。上限為零或缺少時不顯示計量器，並區分未回報上限與明確未設定上限。發生 OOM kill 後，「鍵值清單」也會顯示次數。位元組比值兩側單位相同時只寫一次，例如 70／268 MB。

• 圖表卡片至少占一列的三分之二時，每條序列的峰值與平均值顯示在圖表旁，包括自動寬度的流量卡片與數值卡片。寬鍵值指標卡片在讀數旁顯示相同統計。
• 至少有四列的寬清單小工具使用兩欄。長名稱換行，不再截斷。通知依內容增加高度，不再設定列數。
• 環形圖從儀表板寬度的三分之二起放大圓環、縮窄圖例。節點延遲從半列寬起將最低與最高值放在圖例列上。方格圖在圖例上方置中。
• 窄環形圖的名稱、數值與占比保持在同一列；面板的大型環形圖不需捲動即可顯示全部項目。面板的小型通知占整列，小型節點延遲以名稱與數值代替狹窄的圖。窄面積圖省略會重疊的時間標籤。
• 累計流量、DNS 應答與網路分類最多占半列，快速切換群組最多占三分之二且不重複標題。兩種分類顯示全部類別，不再設定列數。已儲存但不再提供的尺寸會採用最接近的可用尺寸。
• 面板的鍵值指標小工具不再提供與中型相同的大型尺寸。迷你折線圖在第二個樣本到達前顯示基線；速率圖例不會隨讀數變化而改變高度。

面板移動、固定、嵌入與編輯器捲動見介面導覽。

主題與配色

亮色主題的提示徽章、警告與資訊提示訊息使用白色文字，包括黃色提示。

「玻璃」分區有「液態玻璃」「玻璃」「毛玻璃」與「著色」四種配色。「液態玻璃」僅在 Chromium 核心的瀏覽器中產生折射，Firefox 與 Safari 將其繪製為「玻璃」。

設定 > 外觀提供配色方框；選擇玻璃配色後，還提供背景圖片、可讀性遮罩與模糊程度控制項。自訂背景圖片也顯示在登入頁後方。

瀏覽器中儲存的設定

localStorage 儲存目前網站來源的偏好、布局與連線設定檔，包括 Token，以及密碼登入的工作階段 token。工作階段由所有分頁共用，保留至登出、honk 傳回 401 或其連線設定檔被刪除，關閉分頁不會結束工作階段。sessionStorage 只儲存各分頁自己的狀態，例如各分區最近造訪的頁面。honk 儲存後端組態並管理密碼工作階段，工作階段時限為 12 小時，重新啟動後會失效。清除瀏覽器資料會遺失連線設定檔、偏好與工作階段 token，不會刪除 honk 的組態。

Token 模式下，請求透過 Authorization 傳送已儲存的 Token；配對連結可透過網址片段傳遞 Token，載入後移除該片段。儲存鍵見 storage.ts。

儲存的主題與語言在第一幀之前就套用，重新載入不會閃出預設外觀。

「設定 > 外觀」在「語言」旁提供「日期格式」與「時間格式」。「日期格式」預設為「自動（瀏覽器地區）」，與介面語言無關。「日/月/年」「月/日/年」與「年-月-日」可覆寫瀏覽器的日期順序。

「時間格式」預設為「24 小時制」。「12 小時制」使用介面語言的上午、下午文字；「自動（瀏覽器地區）」依瀏覽器地區的慣例顯示。此設定適用於頁面上的所有時間，包括圖表座標軸與日誌熱圖，可與每種日期格式組合，並儲存在目前瀏覽器中。

在 HTTPS 或 localhost 下，service worker 預先快取應用程式外殼，並快取字型與圖示，離線也能開啟頁面，網站可安裝成應用程式。API 回應一律不快取。安全問題的回報方式見 SECURITY.md。

登入前不會下載其他頁面。安裝更新時，不會重新下載頁面已有的檔案。