doona
為第一條連線設定路由
示範
繁體中文

為第一條連線設定路由

從快速啟動繼續,保持 honk 運作並以管理員身分登入。你需要一個可用的 HTTP 或 HTTPS 訂閱 URL,以及閘道器的 shell 存取權限。本教學將 example.com 送入名為 proxy 的新群組,其他流量保持直連。訂閱名稱使用 harbor。

1. 新增訂閱

開啟節點頁,選擇新增訂閱。在名稱中填寫 harbor,在訂閱網址中填寫供應商的 URL,然後選擇新增。doona 會寫入宣告並請求更新。

檢查成功通知是否顯示節點數,再選擇 harbor 檢視其節點。如果宣告已儲存但擷取失敗,先解決回報的錯誤,再選擇卡片上的更新 harbor。訂閱包含代理節點後再繼續。

控制項無法使用時,請查閱節點與訂閱條件或更新條件。

2. 建立群組

開啟策略頁,選擇新增群組。在群組名稱中填寫 proxy,將選擇方式設為平均最快。在訂閱中選擇 harbor,檢查符合的節點後選擇建立。

頁面應出現 proxy 卡片,其中包含訂閱成員。展開卡片,檢視所選成員及其延遲或健康狀態。群組內沒有節點時請勿繼續。控制項無法使用時,見群組建立與編輯條件。

3. 將測試網域送入群組

開啟規則 → 路由規則。如果顯示檢視切換,先選擇進階,再選擇新增規則。

欄位 值
條件寫法 選擇
依據 完整網域
值 example.com
出站 proxy
插入位置 最後(fallback 之前)

選擇對話框中的新增規則,立即寫入並重載。檢查新規則已生效通知及新增規則:

domain(full: example.com) -> proxy

保留 fallback: direct。新增功能無法使用時,見路由規則條件。

4. 定義 DNS 上游

快速啟動沒有 DNS 區塊。開啟組態 → 設定檔,在設定檔中選擇 /etc/honk/config.dae,將以下區塊附加到現有區塊之後。保留剛才建立的訂閱、群組和路由規則。

# 透過代理群組傳送指定的 DNS 請求。
dns {
    # 使用數字伺服器位址,避免依賴其網域的初始解析。
    upstream {
        remote_dns: 'https://1.1.1.1/dns-query' -> proxy
    }
    # 保留其他請求的原目的地。
    routing {
        request {
            fallback: asis
        }
    }
}

選擇套用,等待檔案已寫入、組態已重載的通知。重新開啟檔案,檢查 remote_dns 是否存在。編輯器或套用無法使用時,見組態寫入條件。

5. 新增並套用 DNS 規則

開啟規則 → DNS 規則,在request 規則中選擇新增規則。將依據設為完整網域,在值中填寫 example.com,在動作中選擇 remote_dns,將插入位置設為最後(fallback 之前)。

選擇新增規則以寫入並重載。檢查新規則已生效通知及請求規則:

qname(full: example.com) -> remote_dns

兩條規則現已套用。路由規則選擇流量使用的群組;DNS 規則選擇解析器,該解析器的請求也經過此群組。以上每次儲存都會單獨生效。新增功能無法使用時,見 DNS 規則條件。

6. 用追蹤模擬驗證規則

在規則頁開啟追蹤模擬。將網路協定設為 TCP,網域填寫 example.com,目的連接埠填寫 443。目的 IP留空,在解析模式中選擇不解析(none),再選擇開始追蹤。

結果應符合你的網域規則,出站為 proxy,節點鏈中包含 harbor 的節點。改用 example.net 再執行一次,出站應為 direct。追蹤只模擬規則評估,不建立連線,也不能證明代理可以存取網站。控制項無法使用時,見路由追蹤條件。

7. 觀察真實連線

發出請求前先開啟連線頁。在閘道器執行:

curl --http1.1 --limit-rate 32 https://example.com/ -o /dev/null

傳輸期間,在連線頁找到 example.com 並開啟對應列。檢查節點鏈是否包含 proxy 和 harbor 的某個節點。短連線可能在檢視前已經結束,必要時再次發出請求。傳輸成功表示此路由能承載真實流量。頁面無法使用時,見連線條件。

代理流量由使用者空間處理,會出現在連線頁。直連流量由核心轉送,不會出現在該頁。使用追蹤檢查直連回退,或檢視組態參考中的完整檔案範例。

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。