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. Он перенаправляет TCP/UDP-трафик, который проходит через LAN или исходит с самого хоста, через настраиваемые исходящие протоколы с помощью eBPF.
honk — это самостоятельный прокси-демон или библиотека, которую я импортирую в код?Это самостоятельный бинарный файл, который вы запускаете на Linux-хосте или роутере. Он управляется конфигурационными файлами в стиле dae, совместимым с Clash REST/WebSocket API и набором CLI-инструментов honk-tool. Это не библиотека.
Как мне установить и запустить honk?Скачайте готовый статический архив для вашей платформы (Linux, x86_64 или aarch64) со страницы Releases. Сборка 'full' включает оба API и встроенный интерфейс doona. Затем следуйте руководству по запуску: там описаны проверка ядра и подключения. Пользователи OpenWrt могут установить honk из пакетного репозитория daeuniverse.
Что нужно моей системе, прежде чем я смогу это запустить?Нужны root-доступ, ядро Linux 6.12 или новее с необходимыми опциями ядра и смонтированный bpffs. Обычная сборка cargo build --release не включает настоящий eBPF-датапас, поэтому для реального прозрачного проксирования используйте релизные бинарные файлы.
Чего honk пока не поддерживает?Это ранняя альфа-версия, в которой ожидаются несовместимые изменения. Сейчас в ней нет движка FakeIP и полного паритета функций с mihomo. Также нет датапаса для Windows или macOS: пока это только eBPF под Linux.
Через какие прокси-протоколы 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. Она следует датапасу eBPF и синтаксису конфигурации dae, а также дизайну групп исходящих соединений и Clash API из sing-box. Но honk не является портом ни одного из этих проектов.
Какие стратегии выбора исходящего соединения доступны?Selector (по умолчанию), URLTest, LoadBalance, Fallback и Score. Стратегия Score учитывает бизнес-наблюдения с ограниченной проверкой, чтобы выбрать лучший исходящий узел.
Какие есть похожие проекты?Open-Box, 3X-UI_KIT, fancyss_history_package, goproxy, Shadowrocket, 3x-ui, shadowsocks-rust, BPB-Worker-Panel
Автор
daeuniverse
Размер
71.4 MB
Звёзды
1.9K
Обновлён
КоммитNov 17
Возраст
3 мес
Коммиты · 90 дней