doona
常見操作
示範
繁體中文

常見操作

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

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

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

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

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

  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. 在「網域」輸入網域,選擇「類型」。提供「上游」時,保留「自動」以遵循 dns.routing,或選擇 dns.upstream 中的上游。按「查詢」。
  3. 在結果卡片查看快取狀態、「狀態」「上游」「路由來源」「路由規則」「耗時」與回應。
  4. 如需查看先前的解析,選擇「解析記錄」分頁,再選取一列查看詳細資料。

結果欄位與記錄控制項的說明見 DNS 指南。

更新地理資料

  1. 開啟「設定」>「設定」。
  2. 「地理資料」卡片提供「立即更新」時,按「狀態」旁的該按鈕。卡片也列出地理資料檔案。

更新操作下載檔案,啟用驗證時驗證校驗和。內容有變更時取代對應檔案並重載組態;內容相同的檔案不會重寫。所有內容均未變更時,更新成功但不啟用或重載。提示顯示操作結果。「重設為預設值」經確認後移除地理資料覆寫值與來自設定檔的值,恢復內建來源與預設值。詳見組態與設定與疑難排解。

在 doona 外修改檔案後重載 honk

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

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

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

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

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

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。