doona
標準版與 doona lite
示範
繁體中文

標準版與 doona lite

標準版用於管理組態與觀測流量。需要流量儀表板、連線控制、日誌、進階路由追蹤或多組態來源編輯時,應選擇標準版。

doona lite 專注於設定節點、訂閱、策略群組、路由、DNS 與全域設定。需要任務專用表單、手動節點分享與組態草稿確認流程,且無需流量頁面時,可選擇 lite。

功能比較

功能取決於 honk 宣告的資源與權限;切換版本無法啟用後端未提供的能力。

功能 標準版 doona lite
流量監控 活動、系統狀態、連線、分流、日誌與事件 無流量頁面
小工具 活動小工具,以及懸浮或嵌入側邊欄的小工具 不提供
關閉連線;匯出事件 支援 不提供
路由測試 規則 → 追蹤模擬,含進階流量欄位與解析選項 路由 → 測試規則,顯示命中規則與出站;使用相同的路由追蹤 API
DNS 查詢、解析記錄、統計與快取 支援 無獨立查詢或觀測頁面;路由測試會使用 DNS 解析
節點、訂閱與策略群組選擇 支援;策略群組位於策略頁面 支援;節點、訂閱與策略群組各有獨立頁面
多行分享連結匯入 支援 支援,入口為新增節點 → 貼上連結
分享連結與 QR code 無專用分享對話框 可分享手動節點與訂閱連結;無法分享訂閱節點
重新命名訂閱 支援,可選擇同步更新策略群組參照 不支援;名稱建立後固定
策略群組編輯 策略群組表單與完整組態來源編輯器 策略群組表單、策略群組文字編輯器、建立策略群組副本及跨群組複製成員
路由與 DNS 規則 表單與完整組態來源編輯器 表單、排序控制項與頁面內的視覺化/文字模式
DNS 上游預設 在組態來源編輯器中修改上游;無預設表單 自訂上游,以及阿里 DNS、DNSPod 與 Cloudflare 預設
全域設定 組態 → 全域設定 設定對話框;需重新啟動的值為唯讀,並提供複製按鈕
組態來源 選擇與編輯 main/include 組態來源,建立組態來源並檢視診斷 僅編輯 main;無完整組態來源編輯器
匯出組態 匯出選定的組態來源 匯出已套用的 main,或目前頁面尚未儲存的草稿
後端管理 多後端連線、登出、暫時執行時覆寫與地理資料管理 無對應管理介面
伺服器組態備份與修訂 honk 宣告 x-honk 擴充時可用 不提供
佈景主題與登入 淺色/深色佈景主題及配色;管理員憑證或權杖 淺色、深色或跟隨系統,無配色選擇器;使用相同的 honk 憑證

後端要求

請使用執行要求指定的原生 API honk 建置。兩個版本均透過 GET /api 取得認證方式,並讀取 GET /api/v1/capabilities;密碼模式使用 POST /api/v1/auth/setup 或 POST /api/v1/auth/login。其餘端點按功能需要呼叫,並非每次連線均需支援。下表路徑均以 /api/v1 開頭。

功能 honk 資源與端點 版本
組態編輯 可讀寫的 config、config_validate 與 operations;GET /config、POST /config/validate、PUT /config/sources/{source_id}、GET /operations/{operation_id} 兩者均使用;lite 要求 full 驗證,以及完整、雜湊一致且可寫入的 main 內容。後端支援時,標準版會驗證組態來源的修改。lite 的分享連結匯入還需要 syntax 驗證。
節點、訂閱與策略群組 nodes、providers、groups;GET /nodes、GET /providers、GET /groups、GET /groups/{group_id}、POST /providers/{provider_id}/refresh、PUT/DELETE /groups/{group_id}/selection;probes 使用 POST /probes 兩者均使用;lite 透過替換 main 組態來源編輯宣告。標準版還使用節點/訂閱的建立、刪除及策略群組組態端點。
狀態與服務命令 runtime、operations,以及後端宣告的 reload/suspend/resume 能力;GET /runtime、GET /version(僅標準版)、POST /operations/reload、/operations/suspend、/operations/resume,以及操作狀態查詢 兩者均使用;lite 在介面頂欄顯示狀態,無流量儀表板。
路由測試 routing_trace 使用 POST /routing/trace;rules 使用 GET /rules;需要解析網域時,dns_query 使用 POST /dns/query 兩者均使用;可用測試取決於 honk 的解析模式。
流量與 DNS 觀測 traffic_history、memory_history、runtime_memory、runtime_outbounds、datapath、connections、flows、events、logs、dns_log、dns_cache、dns_query;GET /runtime/traffic/history、/runtime/memory/history、/runtime/memory、/runtime/outbounds、/datapath、/connections、/flows、/events、/logs、/dns/log、/dns/cache、/dns/rules,以及 POST /dns/query 與允許寫入時的連線/快取刪除端點 標準版
組態來源與後端管理 POST /config/sources;geodata 使用 GET /geodata 與 POST /geodata/update;runtime_settings 使用 GET/PATCH /runtime/settings;POST /auth/logout 標準版
伺服器備份與修訂 後端宣告的 x-honk 組態匯出/匯入/修訂擴充,位於 /x-honk/config/ 下 標準版;除基本契約外,還須支援這些擴充

lite 重用標準版的 src/api/client.ts,以及基於產生的 src/api/types.ts 的模型;介面與狀態獨立。OpenAPI 契約定義端點結構。編輯前需滿足的條件見 lite 常見操作。

安裝與切換

兩個版本在同一發布版本中提供。標準版使用 doona-<version>.tar.gz,安裝到 /usr/share/doona;doona lite 使用 doona-lite-<version>.tar.gz,安裝到 /usr/share/doona-lite。壓縮檔名稱與安裝目錄不重疊,安裝其中一個不會覆蓋另一個。lite 暫無發行版套件。

honk 的 /ui/ 一次只提供一個版本。將 experimental → native_api → ui 指向所需版本的目錄,然後重新啟動 honk。每個 native_api 欄位都需要重新啟動,重載不足以生效。ui: embedded 僅提供 honk-core 發布建置內嵌的標準版,見最小組態。

要同時使用兩個版本,讓 honk 在 /ui/ 提供其中一個,再用任意靜態伺服器提供另一個目錄。按透過主機名稱或其他來源存取允許第二個來源。

獨立的瀏覽器設定

兩個版本使用相同的 honk 原生 API 與組態。組態修改由兩者共享,但各自儲存瀏覽器設定。

線上示範

體驗標準版示範或 doona lite 示範。

doona

doona 文件

繁體中文
doona 文件首次啟動若只使用直連,請按快速入門操作。 快速入門使用僅直連的 honk 組態啟動 doona 標準版,登入後驗證閘道器本機的流量。 標準版與 doona lite標準版用於管理組態與觀測流量。 系統需求 在 Debian 或 Ubuntu 上安裝在 Debian、Ubuntu 或其他使用 APT 的系統上,從 doona-web .deb 套件安裝 doona,並從同一個發行版本安裝 honk-core。 在 Fedora 或 RHEL 上安裝在 Fedora、RHEL 或其他使用 DNF 的系統上,從 .rpm 套件安裝 doona,並從同一個發行版本安裝 honk-core。 在 Arch Linux 上安裝在 Arch Linux 或其他使用 pacman 的系統上,從 .pkg.tar.zst 套件安裝 doona,並從同一個發行版本安裝 honk-core。 在 Gentoo 上安裝在本機 ebuild 儲存庫中,用 Portage 從 doona 的 ebuild 安裝 doona,並從同一個發行版本安裝 honk-core。 在 OpenWrt 上安裝在 OpenWrt 25.12 上,從發行套件或封存檔安裝 doona,並從同一個發行版本安裝 honk-core。 在其他系統上安裝在符合以下核心需求的 x86_64 或 aarch64 Linux 系統上,從發行封存檔安裝 doona 與 honk-core。 安裝詳解先安裝 honk 並撰寫組態,再安裝 doona 並啟動 honk。 最小組態本頁撰寫能啟動 honk 並提供 doona 的最小 honk 組態,然後手動啟動 honk 檢查組態。 服務管理本頁以 systemd 或 OpenWrt procd 服務的形式運作 honk:先建立一次服務,再列出啟動、停止、重新啟動、重載 honk 以及檢視日誌的命令。 為第一條連線設定路由從快速啟動繼續,保持 honk 運作並以管理員身分登入。 首次登入本頁在瀏覽器中開啟 doona,建立管理員帳戶,並檢查 doona 是否顯示正在運作的 honk。 介面導覽用導覽開啟頁面,用頂端列搜尋或重新整理,用分頁切換檢視。 觀測流量用「活動」與「系統狀態」查看引擎健康,用「連線」「分流」與「DNS」檢查流量。 路由、節點與規則策略管理群組選擇與成員。 組態與設定「組態」頁讀取、驗證並套用 honk 的設定檔。 常見操作本頁介紹標準版;doona lite 請參閱 doona lite。 功能各項功能的前提條件與操作被停用的原因,見功能啟用條件。 doona litedoona lite 為初學者提供較小的介面,用於編輯 honk 組態。 連線 doona lite將 doona lite 連線至 honk 原生 API,或在沒有後端時開啟示範。 doona lite 常見操作使用 doona lite 匯入資源並編輯 honk 組態。 組態參考本頁列出 doona 涉及的 honk DAE 設定、預設值及生效方式。 doona 可以修改什麼doona 透過不同的控制項修改組態來源、執行期狀態、持久儲存的地理資料設定和瀏覽器偏好。 功能啟用條件在表中找到你要使用的標準版功能,再按對應章節檢查前提並啟用。 疑難排解 開發送出 pull request 前先讀 CONTRIBUTING.md。