doona
界面导览
演示
简体中文

界面导览

本页说明登录 doona 后各项功能的位置:四个导航分区、顶部栏,以及页面内的标签页、详情面板与操作菜单。本页还说明暂存、应用与保存的区别,如何确认修改已生效,以及手机上的布局变化。

窗口宽度不小于 1024 px 时,侧边栏按四个分区列出页面。点击页面名称即可打开该页面。

「活动」

  • 「活动」:出站模式、下载与上传速率、活动连接、当前节点、CPU、流量、出站用量、流量最多的设备与域名、内存以及通知。
  • 「系统状态」:引擎状态、流量计数、内存、数据路径挂载点与后端能力,并提供「导出状态 JSON」。

「观测」

  • 「连接」:包含「流量」和「连接」标签页。选中一条连接可查看其路由与可用操作。
  • 「分流」:包含「总览」和「记录」标签页。
  • 「DNS」:包含「统计」「解析记录」「缓存」和「查询」标签页,具体取决于后端提供的功能。
  • 「日志」:引擎实时日志,可按「级别」和「模块」筛选,并提供「暂停」「清空」和「导出」。
  • 「事件」:后端状态变更记录,并提供「导出 JSON」。

「路由」

  • 「策略」:包含「组」和「组成员」标签页。可为组选择节点或调整组成员。
  • 「节点」:节点及其订阅、用量与刷新。后端提供节点列表时会显示「延迟」标签页。
  • 「规则」:包含「路由规则」「DNS 规则」和「追踪模拟」标签页;只有后端提供 DNS 规则时才显示「DNS 规则」标签页。

「设置」

  • 「配置」:包含「模块」「快速设置」「来源」和「校验」标签页;只有可用时才显示「快速设置」。
  • 「设置」:包含「后端」「后端选项」「地理数据」「外观」「后端操作」和「关于」卡片。

后端不提供某个页面时,该页面仍保留在导航中。打开后会显示「此后端不提供该页面」和「回到活动」按钮;详见功能所需条件。

按 ? 打开「键盘快捷键」。先按 g,再于 800 毫秒内按下页面字母,即可打开对应页面,例如 g r 打开「规则」。

使用顶部栏

  1. 点击侧边栏底部的后端指示器。弹出框会显示引擎及版本、连接状态(例如「已连接」或「需要登录」)、API、「后端网址」和「连接方案」。点击「编辑后端」可打开「设置」页的「后端」卡片,点击「关于 doona」可查看版本信息。
  2. 点击搜索框,或按 Ctrl K(macOS 上按 ⌘K)。输入页面、标签页、节点、组或节点来源名称的一部分,也可以输入当前连接、配置文件路径或规则表达式。点击搜索结果即可打开。
  3. 存在暂存规则时,顶部栏会出现带勾选图标和暂存规则数量的按钮。按钮名称为「应用(N)」;规则写入多个文件时为「应用(N),将写入 F 个文件」。点击后会写入全部暂存规则;详见暂存列表。
  4. 点击「重载 honk」,并在「重载 honk?」对话框中确认。honk 会重新读取配置文件并重载,暂存的规则不会写入。只有后端支持重载时才显示此按钮。
  5. 点击「刷新」或按 r,从后端重新读取页面上的全部数据。完成后显示提示消息「数据已刷新。」。刷新不写入任何内容,也不重载 honk。
  6. 点击主题按钮切换浅色与深色。主题跟随系统时,点击后切换为相反的配色方案;再次点击恢复为「跟随系统」。旁边是「语言」和「配色」菜单;「字标」选项位于「配色」菜单中。

「应用(N)」和「重载 honk」不会同时执行:其中一个执行时,另一个不可用。

使用标签页、详情与操作

  1. 点击页面标题下方的标签页,切换页面内的视图。切换标签页不会切换页面。
  2. 在「连接」「分流」或「DNS」中选中一行,打开详情。窗口宽度不小于 1200 px 时,详情显示在列表旁的面板中;窗口较窄时以抽屉显示。
  3. 使用面板中唯一的主要按钮执行主要任务。连接详情的主要按钮是「新建规则」。
  4. 点击「更多操作」(竖排三点按钮)查看其他命令。连接详情中包括「查看命中的规则」「查看流程」「追踪此连接」和「关闭连接」;破坏性操作排在最后。
  5. 点击「关闭」或按 Esc 关闭面板。

暂存、应用或保存

  • 「暂存」只出现在从观测流量打开的「新建规则」对话框中,例如从连接或 DNS 记录打开,且是其中突出显示的按钮。「暂存」把规则加入暂存列表,但不写入;之后可通过顶部栏的「应用(N)」或「规则」页的「应用暂存的规则」写入,详见暂存列表。「规则」页打开的「新建规则」对话框会直接写入;详见新建规则。
  • 「应用」立即把修改写入后端。在从观测流量打开的「新建规则」对话框中,「应用」会立即写入这条规则并重载 honk。「配置」页用「应用」写入编辑后的来源;「设置」页的「后端选项」卡片用「应用」提交运行时修改,这些修改不写入配置文件。详见编辑来源和后端选项。
  • 「保存」把连接方案存储在当前浏览器中。保存后页面会重新加载以应用该连接方案;详见设置。

确认修改已生效

  1. 查看写入后的提示消息。写入规则后会显示「新规则已生效」「规则更改已生效」,或在使用「应用(N)」后显示「N 条规则已生效」。
  2. 查看提示消息中的说明:「现有连接保持当前路由,重新连接后才应用更改。」
  3. 如需检查新路由,打开「连接」,查看修改后新建立的连接。

写入失败时,提示消息会显示原因,未写入的暂存规则仍保留在暂存列表中。配置文件为只读时,请参阅疑难排解。

在手机上导航

窗口宽度小于 1024 px 时,侧边栏由底部导航栏和页面导航条取代。

  1. 在底部导航栏中选择「活动」「观测」「路由」或「设置」。每个分区会打开本次浏览器会话中在该分区最近访问的页面;尚未访问时打开该分区的第一个页面。
  2. 在内容上方的页面导航条中选择页面。页面无法全部显示时,横向滑动导航条;当前页面始终保持可见。
  3. 点击顶部栏的「更多选项」(竖排三点按钮),可使用「语言」「主题」「配色」和「字标」菜单,以及「重载 honk」和「后端」。「后端」会打开与侧边栏后端指示器相同的弹出框。
  4. 搜索按钮、「刷新」和「应用(N)」仍直接显示在顶部栏中,不收入菜单。
  5. 在页面工具栏中,第一个操作保留为按钮,其余操作收入「更多操作」。

安装 honk 与 doona 请参阅安装指南;配置文件请参阅配置。

doona

doona 文档

简体中文
doona 文档doona 是 daeuniverse 引擎共用原生 API 的静态 Web 界面:目前对接 honk,dae 实现同一份契约后也可对接。 系统要求 在 Debian 或 Ubuntu 上安装本页在 Debian、Ubuntu 及其他使用 APT 的系统上,用 .deb 软件包安装 doona,并从同一个 doona 发布版本安装 honk-core。 在 Fedora 或 RHEL 上安装本页在 Fedora、RHEL 及其他使用 DNF 的系统上,用 .rpm 软件包安装 doona,并从同一个 doona 发布版本安装 honk-core。 在 Arch Linux 上安装本页在 Arch Linux 及其他使用 pacman 的系统上,用 .pkg.tar.zst 软件包安装 doona,并从同一个 doona 发布版本安装 honk-core。 在 Gentoo 上安装本页用 Portage 从 doona 仓库中的 ebuild 安装 doona,并从同一个 doona 发布版本安装 honk-core。 在 OpenWrt 上安装本页在 OpenWrt 25.12 上用发布版本中的归档文件安装 doona 与 honk-core。 在其他系统上安装本页在没有 doona 软件包、符合内核要求的 x86_64 或 aarch64 Linux 系统(例如 Alpine Linux)上,用发布版本中的归档文件安装 doona 与 honk-core。 安装详解先安装 honk 并编写配置,再安装 doona 并启动 honk。 最小配置本页编写能启动 honk 并提供 doona 的最小 honk 配置,然后手动启动 honk 检查配置。 服务管理本页把 honk 作为 systemd 或 OpenWrt procd 服务运行:先创建一次服务,再列出启动、停止、重启、重载 honk 以及查看日志的命令。 首次登录本页在浏览器中打开 doona,创建管理员账户,并检查 doona 是否显示正在运行的 honk。 界面导览本页说明登录 doona 后各项功能的位置:四个导航分区、顶部栏,以及页面内的标签页、详情面板与操作菜单。 观测流量本页介绍「活动」分区(「活动」与「系统状态」)及「观测」分区(「连接」、「分流」、「DNS」、「日志」与「事件」)。 路由、节点与规则本页说明「路由」分区中的「策略」「节点」和「规则」三个页面。 配置与设置本页说明「配置」页:在此查看、校验并应用 honk 的配置文件。 常见操作本页汇总调整路由、查看流量与维护 honk 的常用步骤。 配置配置分为两个文件。 功能首先确认网关能够转发流量。 故障排查 开发提交 pull request 前先读 CONTRIBUTING.md。