daeuniverse/honk has 1,675 GitHub stars and 143 forks. GitHot measured +26 stars in 24 hours and +318 in 7 days. Last checked 2026-11-10 21:19 UTC. Last push 2026-11-02.
Inspired by dae & sing-box
可以做什么
- Transparent TCP/UDP for LAN-forwarded and host-originated traffic through TC eBPF, dae0/daens, and compiled routing.
- Outbounds: SOCKS5, Shadowsocks/2022, Trojan, AnyTLS, Hysteria2, TUIC, Juicity, VMess, VLESS, direct, and block. Trojan/VMess/VLESS support H2 XHTTP (packet-up, stream-up, stream-one); VMess is TCP-only. See protocol limits.
- Groups: Selector (the default), URLTest, LoadBalance, Fallback, and Score. Score uses business observations and bounded validation; see group policies.
- DNS: UDP, TCP, DoT, DoH, DoQ, and DoH3 upstreams, optionally through a node or group, with routing and caching.
实测星标增长
- 24小时
- +26
- 7天
- +318
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
README.zh.md
原文早期 alpha，不建议用于生产。 可能发生破坏性变更，部分功能尚未完成，真实环境验证仍然有限。
honk 的 eBPF 数据面和配置语法参考 dae 的设计，出站组与 Clash API 参考 sing-box 的设计。它是独立实现，并非任一项目的移植。
功能概览
- 透明 TCP/UDP：通过 TC eBPF、
dae0/daens和编译路由处理 LAN 转发及本机发起的流量。 - 出站：SOCKS5、Shadowsocks/2022、Trojan、AnyTLS、Hysteria2、TUIC、Juicity、VMess、VLESS、
direct和block。Trojan/VMess/VLESS 支持 H2 XHTTP（packet-up、stream-up、stream-one）；VMess 仅支持 TCP。详见协议限制。 - 组策略：Selector（默认）、URLTest、LoadBalance、Fallback 和 Score。Score 使用业务观测与有界验证，详见组策略参考。
- DNS：支持 UDP、TCP、DoT、DoH、DoQ、DoH3 上游，可经节点或组出站，并提供路由和缓存。
- 配置与控制：dae 语法、订阅、重载、Clash 兼容 REST/WebSocket API，以及
honk-toolCLI 工具箱。
不提供 FakeIP 引擎、完整 mihomo 兼容性或 Windows/macOS 数据面。
安装
从 Releases 下载适合目标平台的归档。发布物支持 x86_64 与 aarch64 Linux，一般用途建议选择 full。
| 构建 | 原生 API | Clash API | 内嵌 doona 与 doona lite |
|---|---|---|---|
full |
是 | 是 | 是 |
native-api |
是 | 否 | 否 |
clash-api |
否 | 是 | 否 |
各构建均提供静态链接的 musl 版本，full 另提供链接 glibc 的 gnu 版本。名称含 stock 的归档使用系统分配器而非 jemalloc。每个版本的 Downloads 一节列出校验和及构建来源证明。
Debian、Ubuntu、Fedora、openSUSE 和 Arch Linux 的软件包安装见安装指南。OpenWrt 用户可使用 daeuniverse 软件源。
自行编译请按从源码构建准备。发布二进制内嵌 eBPF；仅执行 cargo build --release 不会启用真实数据面。
按启动指南检查内核、安装程序并验证连通性。首次部署会修改网络 hook、命名空间和 sysctl，须保留带外管理通道。
网页界面
honk 可配合以下两类网页界面使用：
- doona：基于原生 API，提供运行观测、诊断与配置编辑功能。doona lite 为其轻量预览版。在线演示见标准版与 lite 版。
- Clash 面板：基于 Clash 兼容 API，例如 zashboard。
使用 full 构建时，在 experimental.native_api 中将 ui 设为 'embedded' 即可启用 doona，设为 'embedded-lite' 则启用 doona lite。native-api 构建可将 ui 设为另行安装的 doona 所在目录。配置步骤见 doona 快速入门。启用 Clash 面板需配置 experimental.clash_api，honk 首次启动时自动下载 zashboard。各设置项的说明见 experimental 设置。
文档
文档索引汇总中英文配置指南、原生与 Clash API 参考、子系统设计及运维指南。
版本与兼容性
- 自
v0.1.0起，发布遵循 SemVer；带-alpha.N、-beta.N或-rc.N后缀的标签为预发布。1.0之前，次版本可能改变配置或行为，升级前应阅读发布说明。 - 透明代理需要 root 权限、Linux 6.12+、所需内核选项和 bpffs。详见上方链接的启动指南。
- 配置使用 dae 语法。修改已有部署前，请查阅 NFQUEUE 运行说明和 VLESS 迁移指南。
- 原生 API 使用
/api/v1，其契约在1.0之前可能随次版本变化。GET /api/v1/version返回契约标识。
开发
工作区包含配置、共享 eBPF 类型、NFQUEUE、出站、核心和工具 crate；crates/honk-ebpf 单独构建。详见 Justfile 与贡献政策。
无 root 的用户态开发可使用 mock 模式。--mock-ebpf 不会拦截流量，不能代替数据面测试。
滚动的 Debug 预发布提供来自 main 的最新 debug.* 测试构建。它们使用 release profile，并非 Cargo debug profile；保留期限与发布流程见发布规则。
报告问题
代理、路由和 DNS 问题请提交至 honk issues；网页界面问题请提交至 doona issues。
安全漏洞请按 SECURITY.md 报告。
致谢
- dae / daed-rs：eBPF 透明代理谱系
- sing-box：出站组与 Clash API 模式
- daeuniverse/outbound：协议参考
- juicity-rs（Markson Pigeonzilla Plus）：Juicity 协议参考、wire 格式对齐及真实互通测试
- aya-rs：Rust eBPF
许可证
SPDX-License-Identifier: GPL-3.0-only
Copyright (c) 2025, glassyiris <[email protected]> and honk contributors
仅用于开发的 dae 解析器 oracle链接了 dae（AGPL-3.0-only）。它不随发布物分发，也不链接进 honk-core。
TODO
- 评估 AF_XDP 与 XDP 路径以进一步提升性能
- 在 Clash 兼容 API 之外添加 honk 专用 REST API
- 添加入站支持
- 探索 macOS 与 Windows 支持；数据面基于 Linux eBPF，这两个平台需要另一种接管流量的方式