OpenWrt / ImmortalWrt 25.12 透明代理一体包(内核 6.12+,7 架构 APK)
honk 核心 + Doona Web 界面 + luci-app-honk 管理界面
概览![]() |
配置![]() |
维护![]() |
Doona 核心界面![]() |
| 组件 | 说明 |
|---|---|
| honk | 基于 eBPF 的透明代理核心,dae 风格的 Rust 重写。流量在内核态分流,直连流量几乎零开销,适合做软路由主力代理 |
| luci-app-honk | LuCI 管理界面:概览、配置(订阅 / 粘贴节点 / dae 导入)、日志、维护(Geo 数据、软件包升级、配置备份、系统检查) |
| Doona | 核心自带 Web 界面,随 LuCI 包安装到 /usr/share/doona,管理节点、分组、路由、DNS 与订阅,不另起服务 |
| 架构 | 状态 |
|---|---|
x86_64 |
主力支持(软路由) |
aarch64_cortex-a53 · aarch64_cortex-a72 · aarch64_cortex-a76 · aarch64_generic |
支持,ARM64 设备(含树莓派 5 等 a76 设备) |
arm_cortex-a7_neon-vfpv4 · arm_cortex-a9 |
实验性:25.12 内核满足 6.12,但上游只发 x86_64 / aarch64,这两个由源码交叉编译,尚未做真机验证 |
- 稳定版核心要求 Linux 6.12+,目前公开安装入口对应 OpenWrt / ImmortalWrt 25.12;安装脚本会先检查内核。
- 稳定版提供
.apk(25.12 / 内核 6.12+)。24.10 走 Linux 6.6 实验通道,提供.ipk,内核要求 6.6.40+,安装方式见下。 - 自己编固件的话,内核选项、依赖模块和常见的编译报错都写在自行编译固件。
兼容核心基于 6106757-lab/honk 的 kernel-floor-6.6 分支,继承该分支的功能与限制。每天跟一次该分支,有提交才重新出包;固定提交和 OpenWrt 集成补丁摘要位于 ci/pins-linux66.env,与稳定通道独立。
- 最低内核
6.6.40。官方 OpenWrt 24.10.8(内核 6.6.144)已通过安装、启停、重启、升级与真实流量验证;其余架构编译通过不等于已做真机验收。 - 兼容包复用 LuCI 和 Doona,面板概览显示「Linux 6.6 实验版」;需要匹配的内核模块,以及内置或按
uname -r精确匹配的外部 BTF。 - 发布走独立的预发布 Release(tag 形如
linux66-<日期>-r<run_id>,包版本按日期)与openwrt-feed/honk/24.10/<arch>/,由聚合工作流统一生成并签名 opkg 索引;linux66.yml每天自动跟上游分支,有新提交就构建并发布;手动触发要勾publish才发。 - LuCI 一键升级只允许同通道(6.6 核心从 24.10 源升级、稳定核心从 25.12 源升级),跨通道会被拒绝。
- 两个通道的配置备份不能互导(恢复会报
incompatible_core_version),换通道请手工搬node {}块。 - UDP 会话容量取决于文件描述符和内存预算。本地
nofile=4096验证中上限为 168 个,高频新建会话达到上限后会丢包,空闲回收后恢复;不适合作为高并发支持承诺。 - 内核不提供 kprobe BPF 时,UDP 内核路径观测会降级;外置 BTF 不能补齐这一能力,不能只按
6.6版本号认定功能完整。 - AArch64 模拟环境的连续规则重载测试出现过短暂 UDP 丢包;无重载对照通过,目前不承诺重载期间 UDP 无损。
Linux x86_64 构建机上可执行:
CORE_LANE=linux66 CORE_ARCHS=x86_64 bash ci/build-core.sh
python3 ci/prepare-linux66-package.py核心归档与兼容信息写入 artifacts/cache/ 和 honk/generated-linux66-*,实验包源码准备到 artifacts/linux66-package/。将其中的 dl/ 复制到 24.10 SDK 的 dl/,再编译 honk 与 luci-app-honk;此流程用于本地验收,版本号尚未分配为新的公开 Release。
更换或卸载实验包前,先在 LuCI 停止服务并确认已停止,再操作软件包管理器。
# 大陆推荐:jsDelivr 镜像,比 ghfast 之类的加速站稳定
wget -O - https://cdn.jsdelivr.net/gh/kenzok8/openwrt-honk@main/scripts/install.sh | ash# 直连 GitHub:镜像还没同步到最新脚本时用
wget -O - https://raw.githubusercontent.com/kenzok8/openwrt-honk/refs/heads/main/scripts/install.sh | ash
- jsDelivr 对
@main有缓存(最长约 12 小时),刚改过的脚本可能延迟生效;脚本执行时仍会去 GitHub 取最新 Release,装到的版本不受影响。- 安装包下载默认走
GH_PROXY(https://ghfast.top/),失败自动回落直连 GitHub。换加速站:GH_PROXY=https://你的加速站/ wget -O - ... | ash。- 脚本会复用设备已有的 Geo 数据包;缺少时从聚合源下载,失败则用设备现有软件源。
装了什么:
honk—— honk-core 二进制 + 服务脚本 + 默认配置luci-app-honk—— LuCI 界面 + 中文翻译(编译进主包)+ Doona 资产- Geo 数据来自
v2ray-geoip/v2ray-geosite,与 daede 共用/usr/share/v2ray,可在维护页手动或定时更新
wget -O - https://cdn.jsdelivr.net/gh/kenzok8/openwrt-honk@main/scripts/uninstall.sh | ash两条路,选一条即可。
① 重跑安装脚本(不用配软件源,最稳)
wget -O - https://cdn.jsdelivr.net/gh/kenzok8/openwrt-honk@main/scripts/install.sh | ash② 加软件源,之后在 LuCI「服务 → Honk → 维护 → 软件包更新」里点升级
wget -qO- https://down.dllkids.xyz/openwrt-feed/openwrt-feed-setup.sh | sh「软件包更新」卡片只查本机 apk/opkg 源,不查 GitHub。用安装脚本装的机器没有把 feed 写进源,卡片会一直显示「已是最新」;先跑上面这条软件源脚本(装公钥 + 写源 + 刷索引)卡片才有用。 刚发布的版本要等 feed 同步过去才会进索引,急着升级直接重跑安装脚本。
在 LuCI「服务 → Honk」初始化服务,运行系统检查后启动。Doona 界面仅在已初始化、正在运行且 API 就绪时开放。
节点与订阅直接写进 /etc/honk/config.dae(node { label: 'share-link' } 或 subscription { tag: 'url' }),重载 Honk 后生效;路由、DNS 与订阅也可以只在 Doona 面板里管。
管理入口和 API 只应在可信 LAN 内使用。若 LuCI 走未加密的 HTTP,浏览器到路由器之间的登录信息和 API 流量没有传输加密,请勿把管理页面暴露到互联网。
| 包名 | 说明 |
|---|---|
ca-bundle |
CA 证书包 |
kmod-sched-core / kmod-sched-bpf |
eBPF 流量调度 |
kmod-veth |
虚拟以太网设备 |
kmod-nft-queue |
nftables 队列 |
v2ray-geoip / v2ray-geosite |
路由 GeoIP / GeoSite 数据 |
rpcd / luci-base / cgi-io |
LuCI 运行依赖 |
honk-core 用 CO-RE eBPF,缺 BTF 起不来。查找顺序与核心一致:
HONK_VMLINUX_BTF指定的文件 —— 设了它就只认这一个,读不到直接拒绝启动,不回退。/sys/kernel/btf/vmlinux—— 内核自带 BTF 的固件有(如 ImmortalWrt)。/usr/lib/debug/boot/vmlinux—— vmlinux-btf 装的就是这里,官方 OpenWrt 走这条。
补充说明:
- 安装脚本发现两条默认路径都没有时,按内核版本补装
vmlinux-btf:软件源里有当前内核那个版本就直接装;没有就按uname -r去 vmlinux-btf 的 releases 取同版本包(feed 只保留最新一版,内核一换就对不上);两处都没有才只打印提示。同系列补丁号不同的包照装但打警告。 - 自编译或快照内核没有现成包,拿同一次编译的
vmlinux跑pahole --btf_encode_detached=vmlinux.btf vmlinux,放到/usr/lib/debug/boot/vmlinux,或用HONK_VMLINUX_BTF指过去。 - 只有内核自带 BTF 时才启用「原生 UDP 接收追踪」,用外部 BTF 时该功能降级,其余功能不受影响。
固定输入。 核心和 Doona 的完整提交、Doona OpenWrt 补丁摘要、OpenWrt 25.12.4 x86/64 官方 SDK 地址和 SHA256 都固定在 ci/pins.env。Doona 从源码构建并保留 OpenWrt 同源 API 补丁,归档不含可选中文字体,浏览器用系统字体。
自动更新。 核心跟官方 v* tag(eBPF nightly 从上游源码读,不写死),Doona 跟版本号。auto-bump.yml 每天检查一次:官方出新 tag 或 Doona 版本号变了,才在独立分支写入 pin、包版本和归档哈希,跑全部 7 组 SDK 安装包,矩阵全绿直接推进 main、正式 tag、Release 与 R2 软件源;任一 SDK 失败就只留候选分支,不动正式源。
构建环境。 完整构建(含核心)需在大小写敏感的 Linux 文件系统上跑(Doona 上游有仅大小写不同的文件)。需要 Rust / rustup、Zig 0.14.1、Node.js 22.13+ 与 Corepack、Git、curl、ripgrep、GNU tar、zstd、readelf,以及 build-essential、clang、LLVM、libbpf、libelf、pkg-config、CMake、libclang 和 OpenWrt SDK 所需工具。核心交叉编译脚本会核对 Rust / Doona / SDK 输入与 Zig、bpf-linker 版本;SDK 阶段限定 Linux x86_64。
bash scripts/check.sh
ci/build-doona.sh
ci/build-core.sh源码归档写入被 Git 忽略的 artifacts/cache/。7 组 SDK 安装包(7 架构 × SDK 25.12)由 release.yml 构建,它从本次运行独立的源码资产 tag 下载带 SHA256 的阶段文件,任一散列不匹配或安装包缺失都会使构建失败。
本仓库原创集成文件采用 GPL-3.0-only。Honk 核心与 Doona 各自保留上游许可和第三方声明,打包时随软件安装至 /usr/share/licenses/。核心提交、Doona 提交、补丁摘要及实际阶段归档散列记录在构建生成的 provenance 文件中。




