doona
首次登入
示範
繁體中文

首次登入

本頁在瀏覽器中開啟 doona,建立管理員帳戶,並檢查 doona 是否顯示正在運作的 honk。honk 必須處於運作狀態,即服務管理完成後的狀態。

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

開始之前

  • 區域網路中的電腦或手機,或閘道器本機。honk 只接受來自本機、私有網路或鏈路本地位址的管理員建立請求。
  • 最小組態中設定的 listen 位址,例如 192.168.1.1:9527。

1. 開啟 doona

在瀏覽器中開啟以下位址,並把 192.168.1.1 換成你的位址:

http://192.168.1.1:9527/ui/

doona 在同一位址找到 honk 的 API,並將其儲存為後端。尚未建立管理員時,頁面顯示「建立管理員」。

建立管理員表單中的使用者名稱、密碼與確認密碼欄位

登入前可直接使用右上角的三個圖示調整語言、配色與明暗模式。所有螢幕尺寸下,登入表單均顯示為置中的單張卡片。選擇玻璃配色時,自訂背景圖片也顯示在卡片後方。

玻璃桌布上的登入卡片

2. 建立管理員

  1. 在「使用者名稱」中輸入 1 至 64 個字元,只能包含英文字母、數字、_、. 與 -。
  2. 在「密碼」中輸入 8 至 128 個字元的密碼,並在「確認密碼」中再輸入一次。
  3. 選擇「建立並登入」。

doona 登入後開啟「活動」頁。honk 把帳戶儲存在狀態資料庫 /var/lib/honk/state/honk.db 中(OpenWrt 上為 /etc/honk/data/state/honk.db)。之後頁面標題變為「登入」,要求輸入這組使用者名稱與密碼。

密碼工作階段儲存在此瀏覽器中,同一網站來源的所有分頁共享工作階段。關閉分頁或瀏覽器不會結束工作階段;登出、honk 傳回 401 或刪除連線設定檔後,工作階段會清除。honk 將工作階段時限設為 12 小時,重新啟動後會清除所有工作階段。

3. 檢查系統狀態

在側邊導覽列中選擇「系統狀態」。手機上先選擇底部導覽列的「活動」,再選擇頁面導覽列中的「系統狀態」。honk 運作時,該頁顯示:

  • 頁面頂部的「運作中」。
  • 「引擎」卡片:「引擎」下為 honk 與版本;「API」下為 daeuniverse/native v1 (draft);「建置」下為 honk 的提交與所安裝建置的 target。
  • 「後端能力」卡片,列出這個 honk 提供的功能,例如「連線」「日誌」「組態」。

後端指示器開啟的彈出框顯示 honk 版本與連線狀態。在有流量經過 honk 之前,流量計數保持為 0。

至此設定完成。如需讓區域網路裝置經過 honk、加入節點與規則,請參閱組態與功能。

遇到問題時

看到的內容 原因與處理
瀏覽器無法連線 honk 沒有運作,或位址與 listen 不一致。請按服務管理第 3 步檢查,並在閘道器上執行 curl http://192.168.1.1:9527/api。閘道器上的防火牆也可能攔截 9527 埠。
「此 honk 建置沒有提供原生 API」 已安裝的 honk-core 沒有原生 API。請安裝 doona 發行版本附帶的建置,見 honk 版本。
「後端只接受來自本機、私有網路或鏈路本地位址的管理員建立請求。」 瀏覽器從公用網路位址存取了 honk。請在區域網路裝置或閘道器本機上開啟 doona。
「使用者名稱或密碼錯誤。」 重新輸入。如需替換忘記密碼的管理員,先停止 honk,執行 sudo /usr/local/bin/honk-core admin reset(在 root shell 中去掉 sudo;OpenWrt 上執行 /usr/bin/honk-core --data-dir /etc/honk/data admin reset),再啟動 honk,頁面會重新顯示建立管理員。
顯示「需要 Token」而不是建立管理員 api.dae 設定了 secret 而不是 password_auth: true。請把該 secret 作為 Token 輸入,或按最小組態修改 api.dae 後重新啟動 honk。

Token 登入頁面,顯示 Token 欄位、顯示或隱藏控制與連線按鈕

在 Token 欄位輸入後端 secret,可用顯示或隱藏按鈕檢查內容,再按「連線」。doona 將 Token 儲存在目前瀏覽器的連線設定檔中。

更多內容見登入問題。

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。