最小組態

本頁撰寫能啟動 honk 並提供 doona 的最小 honk 組態，然後手動啟動 honk 檢查組態。本頁假定 doona 已位於 /usr/share/doona，honk-core 也已安裝，即各安裝頁完成後的狀態。

說明

Debian 與 Ubuntu 的套件名稱為 doona-web 與 doona-web-fonts，安裝於 /usr/share/doona-web 下。請將下文範例中的 ui: '/usr/share/doona' 改為 ui: '/usr/share/doona-web'。

此範例使用兩個檔案。/etc/honk/config.dae 是主檔案。/etc/honk/config.d/api.dae 啟用 doona 所用的原生 API。在加入節點與規則之前，所有連線都直接發出；更完整的範例見組態。

開始之前

• 閘道器上的 shell：可使用 sudo 的使用者，或 root。在 OpenWrt 上，凡是提供「OpenWrt」分頁的地方都選擇它。該分頁的命令以 root 執行，並把 honk 的資料放在 /etc/honk/data，因為 OpenWrt 的 /var 位於記憶體中，重新啟動後清空。
• 進入這台機器的第二種途徑，例如主控台，供第 6 步使用。honk 正式啟動時會改動閘道器的網路設定。

1. 檢視閘道器的區域網路位址

區域網路裝置透過這個位址開啟 doona。

ip -4 addr show

找到區域網路裝置所連線的介面（OpenWrt 上為 br-lan），記下 inet 後面的位址，不含 /24。例如：

    inet 192.168.1.1/24 brd 192.168.1.255 scope global eth0

為後續步驟設定該位址：

LAN_IP=192.168.1.1

2. 建立目錄

sudo install -d -m 0700 /etc/honk /etc/honk/config.d /var/lib/honk

install -d -m 0700 /etc/honk /etc/honk/config.d /var/lib/honk

mkdir -p /etc/honk/config.d /etc/honk/data
chmod 0700 /etc/honk /etc/honk/config.d /etc/honk/data

這些目錄只有 root 可以讀取，因為組態與狀態資料庫中儲存著憑證。

3. 撰寫主檔案

sudo tee /etc/honk/config.dae > /dev/null <<'EOF'
include {
    config.d/*.dae
}

global {
    wan_interface: auto
}

routing {
    fallback: direct
}
EOF

cat > /etc/honk/config.dae <<'EOF'
include {
    config.d/*.dae
}

global {
    wan_interface: auto
}

routing {
    fallback: direct
}
EOF

cat > /etc/honk/config.dae <<'EOF'
include {
    config.d/*.dae
}

global {
    wan_interface: auto
    lan_interface: br-lan
    data_dir: '/etc/honk/data'
    bootstrap_resolver: '127.0.0.1:53'
}

routing {
    fallback: direct
}
EOF

在 OpenWrt 上，bootstrap_resolver: '127.0.0.1:53' 使用 dnsmasq 解析直接下載網址的網域名稱。地理資料網址不得重新導向：使用 raw.githubusercontent.com 等最終網址，不要使用 GitHub 發行版本的網址。

依要處理的流量設定 lan_interface：

• 主路由器：使用 br-lan，用戶端已將這台路由器設為閘道器。
• 旁路由器：使用 br-lan，並將用戶端的閘道器與 DNS 設為旁路由器的區域網路位址；可逐一設定用戶端，也可修改主路由器的 DHCP 設定。
• 僅處理本機流量：省略 lan_interface，與 sudo、root 兩個範例相同。

lan_interface: auto 會選取預設路由所在的介面，在主路由器上通常是 WAN。

4. 撰寫 API 檔案

該檔案使用第 1 步設定的 LAN_IP。

sudo tee /etc/honk/config.d/api.dae > /dev/null <<EOF
experimental {
    native_api {
        enabled: true
        listen: '${LAN_IP}:9527'
        password_auth: true
        config_write: true
        ui: '/usr/share/doona'
    }
}
EOF
sudo cat /etc/honk/config.d/api.dae

cat > /etc/honk/config.d/api.dae <<EOF
experimental {
    native_api {
        enabled: true
        listen: '${LAN_IP}:9527'
        password_auth: true
        config_write: true
        ui: '/usr/share/doona'
    }
}
EOF
cat /etc/honk/config.d/api.dae

cat > /etc/honk/config.d/api.dae <<EOF
experimental {
    native_api {
        enabled: true
        listen: '${LAN_IP}:9527'
        password_auth: true
        config_write: true
        ui: '/usr/share/doona'
    }
}
EOF
cat /etc/honk/config.d/api.dae

輸出的檔案中，listen 一行應為你的位址，例如 listen: '192.168.1.1:9527'。

使用 openwrt.lan 等網域名稱時，須分別在 allowed_hosts 中設定主機與連接埠，在 allow_origins 中設定瀏覽器來源，然後重新啟動 honk。語法與 403 檢查步驟見網域名稱與來源存取。

每個 native_api 欄位都要重新啟動後才生效。其餘欄位見欄位表。

doona beta.19 的 honk-core debug.2026.10.9.native-api.2 附件（提交 eac5e0c5fba5078a7ff4517a3e3851e7fa0f4f8e）內建 doona 0.1.0-beta.19。要在 /ui/ 提供內建介面，將上面的 ui 行改為：

ui: embedded

doona lite 的壓縮檔安裝到 /usr/share/doona-lite，並設定 ui: /usr/share/doona-lite。ui: embedded 僅提供標準版。修改 ui 後必須重新啟動 honk。

使用 ui: embedded 時，獨立的介面套件是可選項。內建介面不含 Noto Sans TC/SC，瀏覽器會使用系統字型。如需提供外部介面檔案或這些字型，安裝 doona 和 doona-fonts，並將 ui 指向安裝目錄，例如 /usr/share/doona；Debian 或 Ubuntu 則使用 doona-web、doona-web-fonts 和 /usr/share/doona-web。

5. 檢查組態

honk 沒有單獨的檢查命令。用 --mock-ebpf 啟動一次：honk 會讀取並接受整份組態，啟動 API 並提供 doona，但不改動網路。

sudo /usr/local/bin/honk-core --config /etc/honk/config.dae --mock-ebpf

/usr/local/bin/honk-core --config /etc/honk/config.dae --mock-ebpf

honk-core --config /etc/honk/config.dae --data-dir /etc/honk/data --mock-ebpf

honk 在前景持續運作。每行以時間戳開頭，其中應包括：

INFO honk_core: honk-core debug.2026.10.9.native-api.2 starting
INFO honk_core: Config: /etc/honk/config.dae
INFO honk_core: Loaded 2 nodes, 0 groups, 0 routing rules
WARN honk_core: NFQUEUE is unavailable at startup; continuing with NFQUEUE staging disabled requested=true reason=the mock eBPF backend was selected
INFO honk_core: Using mock eBPF backend
INFO honk_core: listen=192.168.1.1:9527 native API listener ready
INFO honk_core: honk-core is running. Press Ctrl+C to stop.

使用 --mock-ebpf 時出現 WARN 一行屬於正常情況。honk 運作期間，在第二個終端機中查詢 API，並把 192.168.1.1 換成你的位址：

curl http://192.168.1.1:9527/api

API 返回一行內容；setup_required: true 表示尚未建立管理員：

{"api_major":1,"auth":{"mode":"password","setup_required":true},"links":{"auth_login":"/api/v1/auth/login","auth_setup":"/api/v1/auth/setup"},"name":"dae/honk-native"}

在第一個終端機中按 Ctrl+C。honk 輸出 Received SIGINT, shutting down...，最後輸出 honk-core stopped。

6. 正式啟動 honk 一次

這次啟動會載入 eBPF 程式並掛到組態指定的介面上。請準備好進入機器的第二種途徑。

sudo /usr/local/bin/honk-core --config /etc/honk/config.dae

/usr/local/bin/honk-core --config /etc/honk/config.dae

honk-core --config /etc/honk/config.dae --data-dir /etc/honk/data

日誌中出現同樣的 native API listener ready 與 honk-core is running. Press Ctrl+C to stop.，但沒有 mock 相關的行。按 Ctrl+C 停止 honk；之後由下一頁的服務運作 honk。

下一步：服務管理。

遇到問題時

honk 在以 fatal error, shutting down: 開頭的行或 ERROR 行中給出原因。

啟動成功並不代表每個值都符合預期：honk 會接受某些未知的值而不報錯。更多錯誤訊息見疑難排解。