doona
doona 文档
演示
简体中文
doona 文档

doona 文档

doona 是 daeuniverse 引擎共用原生 API 的静态 Web 界面：目前对接 honk，dae 实现同一份契约后也可对接。honk 是用 Rust 编写的 Linux 透明代理引擎，可以自己在 /ui/ 提供 doona，也可以由任意 Web 服务器提供。doona 显示引擎当前的状态，并管理节点、组、路由规则与配置文件。

使用示例数据体验演示版。

活动页

原生 API 状态

doona 依赖 honk 的原生 API，只有 Glassyiris/honk feat/native-api 分支及其滚动 debug 发布版本的构建提供该 API。在该分支上，构建时须显式启用 native-api；发布与 debug 构建及 doona 0.1.0-beta.12 附带的构建已包含此功能。daeuniverse/honk main 分支的构建会以 unknown experimental setting 拒绝所有 native_api 设置；/api 与 /ui/ 返回 404。feat/native-api 分支的构建若未启用该功能，启用 native_api 时会以 native-api feature is required 阻止启动。本文档已对照 debug.2026.9.30.native-api.5（提交 25377686）核对。上游 honk 正式发布该 API 之前，配置键与默认值仍可能变化。

页面

部署新的网关时，请先阅读系统要求与对应系统的安装页，再按顺序阅读“首次运行”下的最小配置、服务管理与首次登录。首次登录后，请继续阅读“指南”中的界面导览。

  1. 系统要求：内核、honk 构建、浏览器与构建工具。
  2. 在 Debian 或 Ubuntu、Fedora 或 RHEL、Arch Linux、Gentoo、OpenWrt 或其他系统上安装 doona 与 honk-core。
  3. 安装详解：在一页内完成手动安装，以及从其他来源打开 doona、发行版软件包与更新。
  4. 最小配置：能提供 doona 的最小配置，以及检查方法。
  5. 服务管理：以 systemd 或 procd 服务运行 honk，启动、停止、重载并查看日志。
  6. 首次登录：创建管理员并检查概览。
  7. 界面导览：页面、顶部栏、详情面板与更改的提交方式。
  8. 观测流量：活动、系统状态、连接、分流、DNS、日志与事件页面。
  9. 路由、节点与规则：策略组、节点与订阅、规则与追踪模拟。
  10. 配置与设置：配置页与设置页。
  11. 常见操作：常见更改的操作步骤。
  12. 配置：启用原生 API 的 honk 示例配置，以及每个 native_api 字段启用的功能。
  13. 功能：逐项检查 doona 功能所需的设置、各页面读取的资源，以及 doona 在浏览器中保存的设置。
  14. 故障排查：启动错误、状态数据库、缺少原生 API、登录与只读的配置文件。
  15. 开发：构建与测试 doona、源码布局与 API 契约。

链接

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。