doona
常見操作
示範
繁體中文

常見操作

本頁彙整調整路由、查看流量與維護 honk 的常用步驟。每項操作列出預期結果,並連結至對應頁面的詳細說明。

從現有連線讓一個網站經由代理

  1. 開啟「觀測」>「連線」,選擇「連線」分頁。
  2. 選取連至該網站的連線,開啟其詳細資料面板。
  3. 在詳細資料面板按「新增規則」,開啟「新增規則」對話框。
  4. 將「依據」設為「完整網域」。
  5. 將「出站」設為代理群組。對話框會顯示該連線目前的出站與規則預覽。
  6. 檢查「插入位置」。若對話框提示「前面的規則仍可能先命中此流量。」,改選更前面的位置。
  7. 按「套用」立即寫入規則並重載;或按「暫存」,稍後透過頂端列的「套用(N)」寫入。

按「套用」後,提示顯示「新規則已生效」。在「規則」模式下,若沒有更前面的規則先命中,符合的新連線會使用新出站;現有連線重新連線後才改用新路由。此對話框沒有「鎖定此出站」,因此「全域」或「直連」模式仍會覆蓋這條規則;如需在這兩種模式下保留該路由,請在「路由」>「規則」中新增規則並開啟「鎖定此出站」。暫存規則見暫存清單,對話框各欄位見新增規則。

讓一個網域及其子網域經由指定群組

  1. 開啟「路由」>「規則」,選擇「路由規則」分頁。
  2. 按「新增規則」。對話框開啟時,「條件寫法」為「選擇」。
  3. 將「依據」設為「網域後綴」,在「值」輸入網域。多個網域以逗號分隔。
  4. 將「出站」設為目標群組。
  5. 若全域或直連模式下也須依此規則轉送,開啟「鎖定此出站」。
  6. 將「插入位置」設在可能先命中同一流量的規則之前。
  7. 按對話框中的「新增規則」。

doona 將規則寫入其來源檔案並重載。提示顯示「新規則已生效」;現有連線重新連線後才改用新路由。詳見路由、節點與規則。

讓一台裝置不經由代理

規則依裝置的來源 IP 位址比對,因此裝置需要固定位址。

  1. 開啟「路由」>「規則」,選擇「路由規則」分頁。
  2. 按「新增規則」,開啟「新增規則」對話框。
  3. 將「依據」設為「來源 IP」,在「值」輸入裝置的 IP 位址。
  4. 將「出站」設為 direct。
  5. 開啟「鎖定此出站」,使全域模式不會改寫此規則。
  6. 將「插入位置」設在可能先命中該位址的規則之前。
  7. 按對話框中的「新增規則」。

提示顯示「新規則已生效」。該位址的新連線改走 direct,現有連線重新連線後才改用新路由。詳見路由、節點與規則。

為群組選擇節點並恢復自動選擇

  1. 開啟「路由」>「策略」,選擇「群組」分頁。
  2. 找到該群組的卡片。
  3. 在卡片的節點網格選取節點。提示會確認選擇結果:節點被固定時,提示說明自動策略已暫停;否則說明現有連線已保留或已中斷。
  4. 若提示說明已手動固定該節點且自動策略已暫停,開啟卡片的「更多操作」選單,按「恢復自動選擇」。

按「恢復自動選擇」後,提示會顯示該群組目前使用的成員。詳見路由、節點與規則。

新增並重新整理訂閱

  1. 開啟「路由」>「節點」。
  2. 按「來源」表格上方的「新增訂閱」,開啟對話框。
  3. 填寫「名稱」與「訂閱網址」,按「新增」。
  4. 之後如需重新整理,按「來源」表格中該訂閱所在列的重新整理按鈕。

按「新增」後,doona 會選取新列。後端支援重新整理訂閱時,doona 會立即重新整理,並在提示中顯示節點數量或失敗原因。詳見路由、節點與規則。

切換至全域模式並選擇出站

  1. 開啟「活動」。
  2. 在「出站模式」卡片選擇「全域」。
  3. 在「全域模式出站」卡片選取出站。
  4. 按「出站模式」卡片中的「套用」。

doona 將模式與出站寫入主組態並重載,提示會確認新的出站模式。詳見觀測流量。

查明連線為何使用某個出站

  1. 開啟「觀測」>「連線」,選擇「連線」分頁,再選取該連線。
  2. 在詳細資料面板查看「出站」「鏈」與「規則」。
  3. 如需開啟命中的規則,開啟詳細資料面板的「更多操作」,按「檢視命中的規則」。「路由」>「規則」頁面會開啟並選取該規則。
  4. 如需測試路由,開啟「更多操作」,按「追蹤此連線」。「追蹤模擬」會開啟,並已填入該連線的資訊。
  5. 按「開始追蹤」。

追蹤依目前組態模擬路由,不會重播該連線。詳見觀測流量與路由、節點與規則。

查看網域如何解析

  1. 開啟「觀測」>「DNS」,選擇「查詢」分頁。
  2. 在「網域」輸入網域,選擇「類型」,按「查詢」。
  3. 在結果卡片查看快取狀態、「狀態」「上游」「路由來源」「路由規則」「耗時」與回應。
  4. 如需查看先前的解析,選擇「解析記錄」分頁,再選取一列查看詳細資料。

詳見觀測流量。

更新地理資料

  1. 開啟「設定」>「設定」。
  2. 若頁面有「地理資料」卡片,按「狀態」旁的「立即更新」。
  3. 否則,在「後端操作」卡片的「地理資料」下按「更新」。

更新操作會下載並驗證檔案,取代現有檔案後重載組態。提示顯示「地理資料已更新並重載」或「無法更新地理資料」。後端不支援手動更新地理資料時,不顯示該按鈕。詳見組態與設定與疑難排解。

在 doona 外修改檔案後重載 honk

  1. 在頂端列按「重載 honk」。窄螢幕下,開啟「更多選項」,按「重載 honk」。
  2. 在「重載 honk?」對話框按「重載 honk」。

honk 會重新讀取組態檔案並重載,暫存的規則不會寫入。需要重新啟動才生效的設定,須待 honk 重新啟動後才生效,詳見組態。頂端列的說明見介面導覽。

處理編輯期間磁碟上已變更的檔案

  1. 開啟「設定」>「組態」,選擇「來源」分頁。
  2. 在「來源」選取該檔案。若開始編輯後磁碟上的檔案已變更,頁面會顯示提示,並停用「套用」。
  3. 如需保留磁碟上的變更,按「取消」。草稿會被捨棄,編輯器顯示檔案的目前內容。
  4. 如需以草稿覆蓋磁碟上的變更,按「保留修改」,再按「套用」。

「保留修改」不會合併兩個版本;「套用」會以草稿覆蓋檔案。詳見組態與設定。

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。