跳转到正文

标准版与 doona lite ​

标准版用于管理配置与观测流量。需要流量仪表板、连接控制、日志、进阶路由追踪或多配置源编辑时,应选择标准版。

doona lite 用于配置节点、订阅、策略组、路由、DNS 与全局设置。需要任务专用表单、手动节点分享与配置草稿确认流程,且无需流量页面时,可选择 lite。

honk 也提供 Clash 兼容 API,供 zashboard 等 Clash 仪表盘使用;doona 不使用此 API(见 honk 的最小配置)。

功能比较 ​

功能取决于 honk 声明的资源与权限;切换版本无法启用后端未提供的能力。

功能标准版doona lite
流量监控活动、系统状态、连接、分流、日志与事件无流量页面
小工具活动小工具,以及悬浮或嵌入侧边栏的小工具不提供
关闭连接;导出事件支持不提供
路由测试规则 → 追踪模拟,含进阶流量字段与解析选项路由 → 测试规则,显示命中规则与出站;使用相同的路由追踪 API
DNS 查询、解析记录、统计与缓存支持无独立查询或观测页面;路由测试会使用 DNS 解析
节点、订阅与策略组选择支持;策略组位于策略页面支持;节点、订阅与策略组各有独立页面
多行分享链接导入支持支持,入口为添加节点 → 粘贴链接
分享链接与二维码无专用分享对话框可分享手动节点与订阅链接;无法分享订阅节点
重命名订阅支持,可选择同步更新策略组引用不支持;名称创建后固定
策略组编辑策略组表单与完整配置源编辑器策略组表单、策略组文本编辑器、创建策略组副本及跨组复制成员
路由与 DNS 规则表单与完整配置源编辑器表单、排序控件与页面内的可视化/文本模式
DNS 上游预设在配置源编辑器中修改上游;无预设表单自定义上游,以及阿里 DNS、DNSPod 与 Cloudflare 预设
全局设置配置 → 全局设置设置对话框;需重启的值为只读,并提供复制按钮
配置源选择与编辑 main/include 配置源,创建配置源并查看诊断仅编辑 main;无完整配置源编辑器
导出配置导出选定的配置源导出已应用的 main,或当前页面尚未保存的草稿
后端管理多后端连接、退出登录、临时运行时覆盖与地理数据管理无对应管理界面
服务器配置备份与修订honk 声明 x-honk 扩展时可用不提供
主题与登录浅色/深色主题及配色;管理员凭据或令牌浅色、深色或跟随系统,无配色选择器;使用相同的 honk 凭据

后端要求 ​

请使用运行要求指定的原生 API honk 构建。两个版本均通过 GET /api 获取认证方式,并读取 GET /api/v1/capabilities。密码模式使用 POST /api/v1/auth/setup 或 POST /api/v1/auth/login。其余端点按功能需要调用,并非每次连接都需要支持。下表路径均以 /api/v1 开头。

功能honk 资源与端点版本
配置编辑可读写的 config、config_validate 与 operations;GET /config、POST /config/validate、PUT /config/sources/{source_id}、GET /operations/{operation_id}两者均使用;lite 要求 full 验证,以及完整、哈希一致且可写的 main 内容。后端支持时,标准版会验证配置源的修改。lite 的分享链接导入还需要 syntax 验证。
节点、订阅与策略组nodes、providers、groups;GET /nodes、GET /providers、GET /groups、GET /groups/{group_id}、POST /providers/{provider_id}/refresh、PUT/DELETE /groups/{group_id}/selection;probes 使用 POST /probes两者均使用;lite 通过替换 main 配置源编辑声明。标准版还使用节点/订阅的创建、删除及策略组配置端点。
状态与服务命令runtime、operations,以及后端声明的 reload/suspend/resume 能力;GET /runtime、GET /version(仅标准版)、POST /operations/reload、/operations/suspend、/operations/resume,以及操作状态查询两者均使用;lite 在界面顶栏显示状态,无流量仪表板。
路由测试routing_trace 使用 POST /routing/trace;rules 使用 GET /rules;需要解析域名时,dns_query 使用 POST /dns/query两者均使用;可用测试取决于 honk 的解析模式。
流量与 DNS 观测traffic_history、memory_history、runtime_memory、runtime_outbounds、datapath、connections、flows、events、logs、dns_log、dns_cache、dns_query;GET /runtime/traffic/history、/runtime/memory/history、/runtime/memory、/runtime/outbounds、/datapath、/connections、/flows、/events、/logs、/dns/log、/dns/cache、/dns/rules,以及 POST /dns/query 与允许写入时的连接/缓存删除端点标准版
配置源与后端管理POST /config/sources;geodata 使用 GET /geodata 与 POST /geodata/update;runtime_settings 使用 GET/PATCH /runtime/settings;POST /auth/logout标准版
服务器备份与修订后端声明的 x-honk 配置导出/导入/修订扩展,位于 /x-honk/config/ 下标准版;除基本契约外,还须支持这些扩展

lite 复用标准版的 src/api/client.ts,以及基于生成的 src/api/types.ts 的模型;界面与状态独立。OpenAPI 契约定义端点结构。编辑前需满足的条件见 lite 常见操作。

安装与切换 ​

内嵌标准版请见快速入门,切换到 lite 请见 doona lite,使用独立目录请见单独安装界面文件。

honk 的 /ui/ 一次只提供一个版本。通过 experimental.native_api.ui 选择内嵌界面或目录,再重启 honk,仅重新加载不足以生效。手动安装指南为两个版本使用不同的压缩包与目录,安装其中一个不会覆盖另一个。

若要同时使用两个版本,让 honk 提供其中一个,再用静态服务器提供另一个目录。按主机名与来源访问允许第二个来源。

独立的浏览器设置 ​

两个版本使用相同的 honk 原生 API 和配置。配置修改由两者共享,但各自保存浏览器设置。

在线演示 ​

体验标准版演示或 doona lite 演示。


来源:doona 上游文档,采用 CC BY 4.0 许可证。