doona
doona 文件
示範
繁體中文
doona 文件

doona 文件

doona 是 daeuniverse 引擎共用原生 API 的靜態 Web 介面：目前對接 honk，dae 實作同一份契約後也可對接。honk 是以 Rust 撰寫的 Linux 透明代理引擎，可自行在 /ui/ 提供 doona，也可由任一 Web 伺服器提供。doona 顯示引擎目前的狀態，並管理節點、群組、路由規則與組態檔案。

使用範例資料體驗示範版。

活動頁

原生 API 狀態

doona 需要 honk 的原生 API，只有 Glassyiris/honk feat/native-api 分支及其持續更新的 debug 發布版本的建置提供此 API。在該分支上，建置時須明確啟用 native-api；發布與 debug 建置及 doona 0.1.0-beta.12 附帶的建置已包含此功能。daeuniverse/honk main 分支的建置會以 unknown experimental setting 拒絕所有 native_api 設定；/api 與 /ui/ 回傳 404。feat/native-api 分支的建置若未啟用此功能，啟用 native_api 時會以 native-api feature is required 阻止啟動。本文件已對照 debug.2026.9.30.native-api.5（提交 25377686）核對。上游 honk 正式發布此 API 之前，組態鍵與預設值仍可能變更。

頁面

部署新的閘道器時，請先閱讀系統需求與對應系統的安裝頁，再依序閱讀「首次執行」下的最小組態、服務管理與首次登入。首次登入後，請繼續閱讀「指南」中的介面導覽。

  1. 系統需求：核心、honk 建置、瀏覽器與建置工具。
  2. 在 Debian 或 Ubuntu、Fedora 或 RHEL、Arch Linux、Gentoo、OpenWrt 或其他系統上安裝 doona 與 honk-core。
  3. 安裝詳解：在一頁內完成手動安裝，以及從其他來源開啟 doona、發行版套件與更新。
  4. 最小組態：能提供 doona 的最小組態，以及檢查方法。
  5. 服務管理：以 systemd 或 procd 服務執行 honk，啟動、停止、重載並查看日誌。
  6. 首次登入：建立管理員並檢查概覽。
  7. 介面導覽：頁面、頂端列、詳細資料面板與變更的提交方式。
  8. 觀測流量：活動、系統狀態、連線、分流、DNS、日誌與事件頁面。
  9. 路由、節點與規則：策略群組、節點與訂閱、規則與追蹤模擬。
  10. 組態與設定：組態頁與設定頁。
  11. 常見操作：常見變更的操作步驟。
  12. 組態：啟用原生 API 的 honk 範例組態，以及每個 native_api 欄位啟用的功能。
  13. 功能：逐項檢查 doona 功能所需的設定、各頁面讀取的資源，以及 doona 在瀏覽器中儲存的設定。
  14. 疑難排解：啟動錯誤、狀態資料庫、缺少原生 API、登入與唯讀的組態檔案。
  15. 開發：建置與測試 doona、原始碼配置與 API 契約。

連結

doona

doona 文件

繁體中文
doona 文件doona 是 daeuniverse 引擎共用原生 API 的靜態 Web 介面：目前對接 honk，dae 實作同一份契約後也可對接。 系統需求 在 Debian 或 Ubuntu 上安裝本頁在 Debian、Ubuntu 及其他使用 APT 的系統上，用 .deb 套件安裝 doona，並從同一個 doona 發行版本安裝 honk-core。 在 Fedora 或 RHEL 上安裝本頁在 Fedora、RHEL 及其他使用 DNF 的系統上，用 .rpm 套件安裝 doona，並從同一個 doona 發行版本安裝 honk-core。 在 Arch Linux 上安裝本頁在 Arch Linux 及其他使用 pacman 的系統上，用 .pkg.tar.zst 套件安裝 doona，並從同一個 doona 發行版本安裝 honk-core。 在 Gentoo 上安裝本頁用 Portage 從 doona 儲存庫中的 ebuild 安裝 doona，並從同一個 doona 發行版本安裝 honk-core。 在 OpenWrt 上安裝本頁在 OpenWrt 25.12 上用發行版本中的封存檔安裝 doona 與 honk-core。 在其他系統上安裝本頁在沒有 doona 套件、符合核心要求的 x86_64 或 aarch64 Linux 系統（例如 Alpine Linux）上，用發行版本中的封存檔安裝 doona 與 honk-core。 安裝詳解先安裝 honk 並撰寫組態，再安裝 doona 並啟動 honk。 最小組態本頁撰寫能啟動 honk 並提供 doona 的最小 honk 組態，然後手動啟動 honk 檢查組態。 服務管理本頁以 systemd 或 OpenWrt procd 服務的形式運作 honk：先建立一次服務，再列出啟動、停止、重新啟動、重載 honk 以及檢視日誌的命令。 首次登入本頁在瀏覽器中開啟 doona，建立管理員帳戶，並檢查 doona 是否顯示正在運作的 honk。 介面導覽本頁說明登入 doona 後各項功能的位置：四個導覽分區、頂端列，以及頁面內的分頁、詳細資料面板與操作選單。 觀測流量本頁說明「活動」分區（「活動」與「系統狀態」）及「觀測」分區（「連線」、「分流」、「DNS」、「日誌」與「事件」）。 路由、節點與規則本頁說明「路由」分區中的「策略」「節點」與「規則」三個頁面。 組態與設定本頁說明「組態」頁：在此檢視、驗證並套用 honk 的組態檔。 常見操作本頁彙整調整路由、查看流量與維護 honk 的常用步驟。 組態組態分為兩個檔案。 功能請先確認閘道器能轉送流量。 疑難排解 開發送出 pull request 前先讀 CONTRIBUTING.md。