honk README

项目的 README,来自 github.com/daeuniverse/honk。合并为一个 markdown 文件:README.md。

honk

An experimental transparent-proxy engine for Linux, written in Rust.

Documentation / Web UI demo / Releases

English / 简体中文

Capabilities / Install / Web interface / Report problems

Early alpha, not recommended for production. Expect breaking changes, incomplete features, and limited real-world validation.

honk follows the design of dae's eBPF datapath and configuration syntax, and of sing-box's outbound groups and Clash API. It is an independent implementation, not a port of either project.

Capabilities

There is no FakeIP engine, full mihomo parity, or Windows/macOS datapath.

Install

Download an archive for your platform from Releases. Releases cover x86_64 and aarch64 Linux; full suits most deployments.

Build Native API Clash API Embedded doona and doona lite
full Yes Yes Yes
native-api Yes No No
clash-api No Yes No

Every build comes as a static musl binary; full also comes linked against glibc (gnu). Archives with stock in the name use the system allocator instead of jemalloc. Each release's Downloads section lists checksums and provenance.

Packages for Debian, Ubuntu, Fedora, openSUSE and Arch Linux are covered in the installation guide. For OpenWrt, use the daeuniverse package feed.

For source builds, follow Build from source. Release binaries embed eBPF; plain cargo build --release does not enable the real datapath.

Follow the startup guide for kernel checks, installation, and connectivity verification. Initial deployment changes network hooks, namespaces, and sysctls; keep an out-of-band management path available.

Web interface

honk works with two kinds of web UI:

doona Activity page with traffic charts and status cards

doona lite Nodes page

For doona, enable experimental.native_api and set ui: 'embedded' in a full build, or ui: 'embedded-lite' for doona lite; the doona quick start walks through it. A native-api build can serve a separately installed doona from its directory instead. For a Clash dashboard, set experimental.clash_api; honk downloads zashboard on first start. The experimental settings list every field of both.

Documentation

The documentation index links configuration guides, native and Clash API references, subsystem designs, and operations guides in both languages.

Versions and compatibility

Development

The workspace contains configuration, shared eBPF types, NFQUEUE, outbound, core, and tooling crates; crates/honk-ebpf builds separately. See the Justfile and contribution policy.

Use mock mode for unprivileged userspace development. --mock-ebpf does not intercept traffic or test the datapath.

The rolling Debug prerelease provides the latest debug.* build from main for testing. These use the release profile, not Cargo's debug profile; retention and publication follow the release rules.

Report problems

Report proxy, routing, and DNS problems in honk issues; report web interface problems in doona issues.

For vulnerabilities, follow SECURITY.md.

Acknowledgments

License

GPL-3.0-only.

SPDX-License-Identifier: GPL-3.0-only
Copyright (c) 2025, glassyiris <[email protected]> and honk contributors

The development-only dae parser oracle links dae (AGPL-3.0-only). It is never shipped or linked into honk-core.

TODO

honk (daeuniverse/honk)

正在搜索数据库…

1.9K ·GitHub
这是什么?honk 是一个实验性的透明代理引擎,面向 Linux,使用 Rust 编写。它借助 eBPF,将局域网转发以及主机自身发出的 TCP/UDP 流量,经由可配置的出站协议重新路由。
honk 是独立的代理守护进程,还是可以导入代码的库?它是一个独立的二进制程序,运行在 Linux 主机或路由器上。通过 dae 风格的配置文件、兼容 Clash 的 REST/WebSocket API,以及名为 honk-tool 的命令行工具箱进行管理,不是库。
如何安装和运行 honk?从 Releases 页面下载适用于你平台(x86_64 或 aarch64 Linux)的预编译静态压缩包。其中 'full' 版本内置两种 API 以及嵌入式的 doona 界面。然后按照启动指南完成内核检查和连通性验证。OpenWrt 用户可以改为从 daeuniverse 软件包源获取。
运行前,我的系统需要什么?需要 root 权限、带有所需内核选项的 Linux 6.12 或更新版本内核,并且已挂载 bpffs。普通的 cargo build --release 不包含真正的 eBPF 数据路径,因此要实现实际的透明代理,必须使用发布版二进制文件。
honk 目前不支持哪些功能?它仍处于早期 alpha 阶段,预计会有不兼容的变更。目前缺少 FakeIP 引擎,也未与 mihomo 的功能完全对齐,并且没有 Windows 或 macOS 数据路径,目前仅支持基于 Linux 的 eBPF。
honk 可以通过哪些代理协议转发流量?支持 SOCKS5、Shadowsocks/2022、Trojan、AnyTLS、Hysteria2、TUIC、Juicity、VMess、VLESS,以及直连和阻断出站,并支持 Trojan/VMess/VLESS 的 H2 XHTTP 传输。
如何为 honk 获取网页控制面板?启用原生 API 并设置 ui: 'embedded'(或 'embedded-lite'),即可从完整版本中提供 doona 控制面板。也可以启用 experimental.clashapi,让 honk 在首次启动时自动下载兼容 Clash 的 zashboard。
honk 与 dae 或 sing-box 有什么不同?它是一个独立的 Rust 实现,遵循 dae 的 eBPF 数据路径和配置语法,以及 sing-box 的出站分组和 Clash API 设计,但并不是这两个项目的移植版本。
有哪些出站选择策略?包括 Selector(默认)、URLTest、LoadBalance、Fallback 和 Score。其中 Score 会综合业务观测指标,并经过有界校验,以选出最佳出站。
大小
71.4 MB
星标
1.9K
更新
提交Nov 17
时长
3个月
提交 · 90 天