系統需求

閘道器

honk 只能在 Linux 上以 root 身分執行。它會載入 eBPF 程式、建立 dae0 連結與 daens 命名空間並修改 sysctl，因此首次啟動時請保留主控台等第二條管理途徑。

• Linux 6.12 或更新版本。核心版本過舊時，honk 會在掛載任何程式之前拒絕啟動。
• 下列核心選項。桌面與伺服器發行版通常已啟用；OpenWrt、Armbian 與 VyOS 需要逐項檢查。
• pname(...) 規則需要 cgroup v2。缺少 cgroup v2 時 honk 仍可啟動，但依程序名稱分流無法使用。
• bpffs 掛載於 /sys/fs/bpf。
• CA 憑證，例如 ca-certificates 套件。缺少時 honk 會以 subscription network startup failed 結束。
• 地理資料更新可能增加小型路由器的記憶體用量。honk 將更新串流寫入磁碟；在 OpenWrt 上使用 mimalloc 建置時，請保留 procd 服務中的 MIMALLOC_PURGE_DELAY=0，讓已釋放的記憶體及時歸還系統。

uname -r
zcat /proc/config.gz 2>/dev/null || cat /boot/config-$(uname -r)

CONFIG_BPF=y
CONFIG_BPF_SYSCALL=y
CONFIG_BPF_JIT=y
CONFIG_DEBUG_INFO_BTF=y
CONFIG_CGROUP_BPF=y
CONFIG_NET_CLS_BPF=y|m
CONFIG_NET_SCH_INGRESS=y|m
CONFIG_NET_CLS_ACT=y
CONFIG_NET_NS=y
# Held-first-packet UDP (NFQUEUE, on by default) also needs:
CONFIG_NF_TABLES=y|m
CONFIG_NF_TABLES_INET=y|m
CONFIG_NFT_CT=y|m
CONFIG_NETFILTER_NETLINK_QUEUE=y|m
CONFIG_NFT_QUEUE=y|m

系統未自動掛載 bpffs 時，請執行：

sudo install -d -m 0755 /sys/fs/bpf
mountpoint -q /sys/fs/bpf || sudo mount -t bpf bpf /sys/fs/bpf
mountpoint /sys/fs/bpf
# To mount it at boot, add this line to /etc/fstab:
# bpf /sys/fs/bpf bpf defaults 0 0

honk 版本

• doona beta.19 的 honk-core 附件來自 Glassyiris/honk feat/native-api 標籤 debug.2026.10.9.native-api.2，提交為 eac5e0c5fba5078a7ff4517a3e3851e7fa0f4f8e。附件啟用需明確選擇的 native-api 建置功能，並內建 doona 0.1.0-beta.19。HONK-SOURCE.txt 記錄標籤與完整 honk 提交，並提供 honk 原始碼與對應 doona 原始碼的連結。設定 ui: embedded 後不需單獨安裝介面套件，也可以將 ui 指向外部目錄。
• daeuniverse/honk main 分支的建置沒有原生 API。honk 會以 unknown experimental setting 拒絕所有 native_api 設定，存取 /api 與 /ui/ 會回傳 404。
• feat/native-api 分支的建置若未啟用 native-api 功能，啟用 native_api 時會以 native-api feature is required 阻止啟動。
• 早期的 feat/native-api 建置可以更新地理資料，但無法設定來源。doona beta.8 和 beta.9 附上的建置兩者皆支援。

執行 honk-core --version 查看已安裝執行檔的版本；執行中的版本請查看 doona「系統狀態」頁的「引擎」卡片或側邊導覽列底部。

瀏覽器與建置