doona
首次登录
演示
简体中文

首次登录

本页在浏览器中打开 doona,创建管理员账户,并检查 doona 是否显示正在运行的 honk。honk 必须处于运行状态,即服务管理完成后的状态。

本页介绍标准版;doona lite 请参阅 doona lite。

开始之前

  • 局域网中的电脑或手机,或网关本机。honk 只接受来自本机、私有网络或链路本地地址的管理员创建请求。
  • 最小配置中设置的 listen 地址,例如 192.168.1.1:9527。

1. 打开 doona

在浏览器中打开以下地址,并把 192.168.1.1 换成你的地址:

http://192.168.1.1:9527/ui/

doona 在同一地址找到 honk 的 API,并将其保存为后端。尚未创建管理员时,页面显示“创建管理员”。

创建管理员表单中的用户名、密码与确认密码字段

登录前可直接使用右上角的三个图标调整语言、配色与明暗模式。所有屏幕尺寸下,登录表单均显示为居中的单张卡片。选择玻璃配色时,自定义背景图片也显示在卡片后方。

玻璃壁纸上的登录卡片

2. 创建管理员

  1. 在“用户名”中输入 1 至 64 个字符,只能包含英文字母、数字、_、. 与 -。
  2. 在“密码”中输入 8 至 128 个字符的密码,并在“确认密码”中再输入一次。
  3. 选择“创建并登录”。

doona 登录后打开“活动”页。honk 把账户保存在状态数据库 /var/lib/honk/state/honk.db 中(OpenWrt 上为 /etc/honk/data/state/honk.db)。此后页面标题变为“登录”,要求输入这组用户名与密码。

密码会话保存在此浏览器中,同一网站来源的所有标签页共享会话。关闭标签页或浏览器不会结束会话;退出登录、honk 返回 401 或删除配置方案后,会话被清除。honk 将会话时限设为 12 小时,重启后会清除所有会话。

3. 检查系统状态

在侧边导航栏中选择“系统状态”。手机上先选择底部导航栏的“活动”,再选择页面导航条中的“系统状态”。honk 运行时,该页显示:

  • 页面顶部的“运行中”。
  • “引擎”卡片:“引擎”下为 honk 与版本;“API”下为 daeuniverse/native v1 (draft);“构建”下为 honk 的提交与所安装构建的 target。
  • “后端能力”卡片,列出这个 honk 提供的功能,例如“连接”“日志”“配置”。

后端指示器打开的弹出框显示 honk 版本与连接状态。在有流量经过 honk 之前,流量计数保持为 0。

至此设置完成。如需让局域网设备经过 honk、加入节点与规则,请参阅配置与功能。

遇到问题时

看到的内容 原因与处理
浏览器无法连接 honk 没有运行,或地址与 listen 不一致。请按服务管理第 3 步检查,并在网关上执行 curl http://192.168.1.1:9527/api。网关上的防火墙也可能拦截 9527 端口。
“此 honk 构建未提供原生 API” 已安装的 honk-core 没有原生 API。请安装 doona 发布版本附带的构建,见 honk 版本。
“后端只接受来自本机、私有网络或链路本地地址的管理员创建请求。” 浏览器从公网地址访问了 honk。请在局域网设备或网关本机上打开 doona。
“用户名或密码错误。” 重新输入。如需替换忘记密码的管理员,先停止 honk,执行 sudo /usr/local/bin/honk-core admin reset(在 root shell 中去掉 sudo;OpenWrt 上执行 /usr/bin/honk-core --data-dir /etc/honk/data admin reset),再启动 honk,页面会重新显示创建管理员。
显示“需要 Token”而不是创建管理员 api.dae 设置了 secret 而不是 password_auth: true。请把该 secret 作为 Token 输入,或按最小配置修改 api.dae 后重启 honk。

Token 登录页面,显示 Token 字段、显示或隐藏控制与连接按钮

在 Token 字段输入后端 secret,可用显示或隐藏按钮检查内容,再点击“连接”。doona 将 Token 保存在当前浏览器的连接配置方案中。

更多内容见登录问题。

doona

doona 文档

简体中文
doona 文档首次启动若只使用直连,请按快速入门操作。 快速入门使用仅直连的 honk 配置启动 doona 标准版,登录后验证网关本机的流量。 标准版与 doona lite标准版用于管理配置与观测流量。 系统要求 在 Debian 或 Ubuntu 上安装在 Debian、Ubuntu 或其他使用 APT 的系统上,从 doona-web .deb 软件包安装 doona,并从同一个发布版本安装 honk-core。 在 Fedora 或 RHEL 上安装在 Fedora、RHEL 或其他使用 DNF 的系统上,从 .rpm 软件包安装 doona,并从同一个发布版本安装 honk-core。 在 Arch Linux 上安装在 Arch Linux 或其他使用 pacman 的系统上,从 .pkg.tar.zst 软件包安装 doona,并从同一个发布版本安装 honk-core。 在 Gentoo 上安装在本地 ebuild 仓库中,用 Portage 从 doona 的 ebuild 安装 doona,并从同一个发布版本安装 honk-core。 在 OpenWrt 上安装在 OpenWrt 25.12 上,从发布软件包或归档安装 doona,并从同一个发布版本安装 honk-core。 在其他系统上安装在符合以下内核要求的 x86_64 或 aarch64 Linux 系统上,从发布归档安装 doona 与 honk-core。 安装详解先安装 honk 并编写配置,再安装 doona 并启动 honk。 最小配置本页编写能启动 honk 并提供 doona 的最小 honk 配置,然后手动启动 honk 检查配置。 服务管理本页把 honk 作为 systemd 或 OpenWrt procd 服务运行:先创建一次服务,再列出启动、停止、重启、重载 honk 以及查看日志的命令。 为第一条连接设置路由从快速启动继续,保持 honk 运行并以管理员身份登录。 首次登录本页在浏览器中打开 doona,创建管理员账户,并检查 doona 是否显示正在运行的 honk。 界面导览用导航打开页面,用顶部栏搜索或刷新,用标签页切换视图。 观测流量用「活动」与「系统状态」查看引擎健康,用「连接」「分流」与「DNS」检查流量。 路由、节点与规则策略管理组选择与成员。 配置与设置「配置」页读取、校验并应用 honk 的配置文件。 常见操作本页介绍标准版;doona lite 请参阅 doona lite。 功能各项功能的前提条件与操作被禁用的原因,见功能启用条件。 doona litedoona lite 为初学者提供较小的界面,用于编辑 honk 配置。 连接 doona lite将 doona lite 连接到 honk 原生 API,或在没有后端时打开演示。 doona lite 常见操作使用 doona lite 导入资源并编辑 honk 配置。 配置参考本页列出 doona 涉及的 honk DAE 设置、默认值及生效方式。 doona 可以修改什么doona 通过不同的控制项修改配置源、运行时状态、持久保存的地理数据设置和浏览器偏好。 功能启用条件在表中找到你要使用的标准版功能,再按对应章节检查前提并启用。 故障排查 开发提交 pull request 前先读 CONTRIBUTING.md。