功能

各项功能的前提条件与操作被禁用的原因，见功能启用条件。

首先确认网关能够转发流量。将示例订阅与节点替换为可用的订阅与节点，然后在真实的局域网客户端上分别测试直连与代理的 TCP、UDP 以及 DNS。honk-core is running、dae0 链路或可访问的 API 都不能证明流量正常。

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

逐项检查功能

示例配置提供下表功能所需的设置；替换占位的订阅与节点后，再逐项检查实际运行情况。

自动记录模式下，流程请求、日志流与 DNS 记录读取各自启用对应记录器，并分别有 60 秒宽限期。连接、分流与规则页打开时会请求流程。已允许但处于空闲状态的记录器属于正常情况。

仍有功能缺失时

• 修改 native_api 后没有重启 honk。重载不会应用这些字段。
• 缺少 config_write: true。native_api 的字段直接写在 experimental 下时，honk 会以 unknown experimental setting 拒绝启动。
• 既没有 password_auth: true，也没有 secret，且未启用匿名 loopback。此时若设置了 enabled: true，honk 会拒绝启动。listen 为 loopback 地址且设置 allow_anonymous_loopback: true 时，读取请求无需 Token。配置写入与受保护的设置修改仍需要凭据。此模式仅用于本地开发。
• 文件包含密钥或与密钥相同的文本，因此 doona 将其显示为只读。
• honk 是早期的 feat/native-api 构建，因此地理数据卡片没有来源设置。请安装 doona 发布版本附带的构建，见 honk 版本。
• Token 模式下状态数据库未能打开，因此地理数据卡片没有可配置的来源与计划控件。文件表格仍会显示；已配置网址且后端支持更新时，仍可手动更新。详见状态数据库问题。
• 仅在以 --store db 运行时出现，本文档不使用该模式：honk 未能记录的修订会阻止后续写入，直到下一次成功激活配置。

登录之后

界面指南与操作步骤见文档目录。

每一次配置来源的写入都经过引擎。doona 带着读取时的哈希发送（If-Match）；磁盘上已变动的文件会返回 412，不会写入。引擎先验证整组来源再保存并重载，重载失败时仍沿用先前的世代。预先验证不会写入，脱敏后的文本也不会写回。运行时设置与组选择走各自的端点，各有检查。

页面与所需资源

所有页面都保留在导航栏中。只有 registry.ts 为页面列出的资源全部不可用时，页面才会标为不可用；后端提供导出、导入或修订时，配置页也可用。打开不可用的页面会显示提示。Ctrl K（macOS 为 ⌘ K）可搜索页面与实时数据，也涵盖设置字段与动作、持久化 global 设置、配置区段与功能入口；选择结果会打开并聚焦控件，不会执行动作，见搜索示例。

小工具

活动页仪表盘与浮动面板共用小工具库。两处都提供「出站失败」「节点可用性」「DNS 延迟」与「订阅额度」。「订阅额度」不在默认布局中，列出每个订阅的到期时间与配额仪表；未报告额度时只显示用量。「来源状态」在提供方报告额度时也会显示用量仪表。

内存默认使用图表。选择「迷你折线图」可显示为类似「下载」与「上传」的数值卡片，仪表盘宽度可从一行的五分之一到整行。面板的中型内存小工具显示常驻内存及 cgroup 用量与上限，大型才显示图表。

内存仪表标为「cgroup 已用」。上限为零或缺失时不显示仪表，并区分未报告上限与明确未设置上限。发生 OOM kill 后，「键值列表」也会显示次数。字节比值两侧单位相同时只写一次，例如 70／268 MB。

• 图表卡片至少占一行的三分之二时，每条序列的峰值与平均值显示在图表旁，包括自动宽度的流量卡片与数值卡片。宽键值指标卡片在读数旁显示相同统计。
• 至少有四行的宽列表小工具使用两列。长名称换行，不再截断。通知按内容增加高度，不再设置行数。
• 环形图从仪表盘宽度的三分之二起放大圆环、缩窄图例。节点延迟从半行宽起将最低与最高值放在图例行上。方格图在图例上方居中。
• 窄环形图的名称、数值与占比保持在同一行；面板的大型环形图无需滚动即可显示全部项目。面板的小型通知占整行，小型节点延迟以名称与数值代替狭窄的图。窄面积图省略会重叠的时间标签。
• 累计流量、DNS 应答与网络分类最多占半行，快速切换组最多占三分之二且不重复标题。两种分类显示全部类别，不再设置行数。已保存但不再提供的尺寸会采用最接近的可用尺寸。
• 面板的键值指标小工具不再提供与中型相同的大型尺寸。迷你折线图在第二个样本到达前显示基线；速率图例不会随读数变化而改变高度。

面板移动、固定、嵌入与编辑器滚动见界面导览。

主题与配色

浅色主题的提示徽标、警告与信息提示消息使用白色文字，包括黄色提示。

「玻璃」分区有「液态玻璃」「玻璃」「毛玻璃」与「着色」四种配色。「液态玻璃」仅在 Chromium 内核浏览器中产生折射，Firefox 与 Safari 将其绘制为「玻璃」。

设置 > 外观提供配色方框；选择玻璃配色后，还提供背景图片、可读性遮罩与模糊程度控制项。自定义背景图片也显示在登录页后方。

浏览器中保存的设置

localStorage 保存当前网站来源的偏好、布局与连接配置方案，包括 Token，以及密码登录的会话 token。会话由所有标签页共享，保留至退出登录、honk 返回 401 或其配置方案被删除，关闭标签页不会结束会话。sessionStorage 只保存各标签页自己的状态，例如各分区最后访问的页面。honk 保存后端配置并管理密码会话，会话时限为 12 小时，重启后会话失效。清除浏览器数据会丢失配置方案、偏好与会话 token，不会删除 honk 的配置。

Token 模式下，请求通过 Authorization 发送已保存的 Token；配对链接可通过网址片段传递 Token，加载后移除该片段。存储键见 storage.ts。

保存的主题与语言在第一帧之前就应用，重新加载不会闪出默认外观。

「设置 > 外观」在「语言」旁提供「日期格式」与「时间格式」。「日期格式」默认为「自动（浏览器地区）」，与界面语言无关。「日/月/年」「月/日/年」与「年-月-日」可覆盖浏览器的日期顺序。

「时间格式」默认为「24 小时制」。「12 小时制」使用界面语言的上午、下午文字；「自动（浏览器地区）」按浏览器地区的习惯显示。此设置适用于页面上的所有时间，包括图表坐标轴与日志热图，可与每种日期格式组合，并保存在当前浏览器中。

在 HTTPS 或 localhost 下，service worker 预先缓存应用外壳，并缓存字体与图标，离线也能打开页面，网站可安装为应用。API 响应一律不缓存。安全问题的报告方式见 SECURITY.md。

登录前不会下载其他页面。安装更新时，不会重新下载页面已有的文件。