修改配置与设置

在 doona 标准版中编辑配置文件或修改设置。配置键及示例见配置参考；存储位置与生效方式见 doona 能修改什么。

选择配置编辑器

在设置分区打开配置。控件不可用时，先检查编辑条件。

标签页	用途
模块	查找配置区段，通过打开页面进入对应编辑器。
全局设置	通过表单修改提供的全局字段。
配置文件	查看或编辑完整的来源文件，检查诊断结果。
备份与修订	导出配置、导入服务器文件或恢复已保存的修订。参阅使用条件。

配置版本标识已接受的配置，旁边的状态显示诊断摘要。后端已脱敏监听密钥的值表示返回文本隐藏了这些值。

默认打开模块；通过来源链接进入或缺少主文件正文时，打开配置文件。只有 doona 支持其设置的引擎才会显示全局设置。

内容不完整表示来源文本不完整，或其 SHA-256 与后端报告的值不符，并不一定是密钥脱敏造成的。这类来源无法在 doona 中编辑，请在主机上修改文件。

订阅在节点中管理，组成员在策略中修改，路由模板和单条规则在规则中编辑。

编辑配置文件

1. 打开配置文件标签页，从配置文件选择器中选择文件。
2. 编辑前检查文件标记。如果只读，参阅来源权限与拒绝原因。
3. 修改文本。未应用表示草稿尚未保存；取消会丢弃草稿。
4. 如果提供校验，点击后检查诊断结果。用跳转定位行，或用打开检查其他文件。参阅校验条件。
5. 点击应用并等待结果。成功通知会显示已写入的文件，并确认配置已重新加载。操作失败或结果未确认时，先阅读通知，再决定是否发送下一次更改。

刷新或关闭页面会丢失未应用的草稿。诊断结果会区分已接受的配置和当前草稿；支持校验时，输入修改会触发新的草稿检查。

文件选择器区分 主配置、引入文件、订阅 和 引擎生成 来源。悬停在线数和大小上可查看加载时间。订阅更新会替换订阅来源，引擎会覆盖生成来源，因此应修改产生它们的配置。在只读来源中输入时，每个文件会提示一次。

已接受配置的诊断会保留到草稿完成验证。应用更改或收到新配置世代后，之前的验证结果会清除。清空级别筛选会回到 全部。旧验证链接会打开 配置文件 中的诊断。

如果编辑期间文件发生变化，保存会暂停。检查该变化后，选择保留修改，再点击应用，即可用草稿覆盖较新的文件；选择取消则丢弃草稿，使用较新的文本。

需要重启的通知表示此次编辑已被拒绝。请按只能通过重启生效的设置处理，不要反复点击应用。

创建引入文件

1. 在配置文件中点击新建文件。
2. 若对话框提供目录和扩展名，只需填写 名称。有多个 路径模式 时先选择一个。否则，在 路径 中填写相对于主配置所在目录的 .dae 路径。
3. 如果提示路径不匹配任何已加载的引入模式，先修正路径。
4. 点击创建。空文件会在编辑器中打开，随后按上述步骤编辑。

使用全局设置表单

1. 打开全局设置，从配置文件选择器中选择要编辑的区段。
2. 按字段标注的单位和范围修改值。配置键的含义见配置参考；重复项须在配置文件中处理。
3. 点击写入并重新加载，或用放弃修改丢弃草稿。离开前检查操作结果。

若写入成功但无法读回新配置，草稿会保留，并提供 重试。

选择器包含主文件及 include 文件中的全局区段；没有全局区段的主文件可新增一个。未设置 使用引擎默认值。清空数值字段会将其设为未设置；整数字段不接受小数点，端口数字不分组，例如 8080。

订阅正文存入状态数据库的 subscription_body 表，数据库位置见配置参考。独立 .sub 文件属于旧存储格式，启动迁移说明见 honk 订阅参考。

导出或恢复配置

打开备份与修订，选择所需操作：

任务	操作
下载已接受的配置	点击导出配置。分享下载文件前，检查其中的凭据。
用服务器文件替换数据库配置	点击导入服务器文件，检查提示后确认。这会读取 honk 启动时使用的文件树，不会上传本地文件。
恢复已记录的修订	打开修订，检查元数据和来源，再点击恢复修订并确认。
检查结果未确认的导入或恢复	使用刷新检查已接受的操作，再决定是否发起另一次写入。

恢复修订前，核对各来源的 SHA-256 值。导入或恢复期间，若数据库当前修订发生变化，需重新核对并确认替换。

只需下载选中的来源文本时，在配置文件中使用下载源文件；分享前同样须检查内容。可用操作和导出限制见备份与修订条件。

打开设置

设置分为通用和外观两个标签页。通用包含后端配置方案、临时运行时覆盖、地理数据、延迟探测和关于。没有连接后端时也能打开此页。

连接或切换后端

1. 在通用 → 后端中选择配置方案，或点击新建配置方案。
2. 在后端网址填写后端根地址或反向代理前缀，不要附加 /api/v1。使用示范数据时填写 mock；空地址无法保存。
3. 使用 Token 认证时填写 Token。使用密码认证时，按登录指南操作。
4. 点击测试连接，检查结果。
5. 点击保存，界面会保存配置方案并重新加载页面。

切换方案或确认方案对话框会丢弃未保存的网址和 Token 修改。重命名配置方案和删除配置方案用于管理已保存的条目。退出登录会结束密码登录会话，或删除本浏览器保存的 Token；删除 Token 不会使其在后端失效。

选择其他连接配置会保存选择并立即重新加载页面。确认 新建配置方案、重命名配置方案 或 删除配置方案 后也会重新加载；新连接配置使用演示数据。

配对链接会填入 后端网址 和 Token，点 保存 后生效。保存只修改此浏览器的连接配置，不修改 honk 配置。测试或登录失败时，见登录故障排除。

修改临时运行时选项

先检查运行时覆盖条件。

1. 打开临时运行时覆盖，检查当前显示的是配置值还是运行时覆盖。
2. 修改提供的日志级别、记录数量、流保留时间或记录模式。
3. 点击应用，或用放弃修改丢弃草稿。查看各项旁的记录状态。

编辑期间若后端运行时选项发生变化，doona 会保留草稿并提示变化。

可用字段包括 日志级别、日志保留条数、DNS 记录保留条数、流程保留条数 和 流程保留秒数。流程记录 提供 按流程需求，日志记录 提供 按日志需求，DNS 记录 提供 按 DNS 日志需求；三者也都提供 常开 和 关闭。记录器状态显示为 记录中、未记录 或 配置禁止。

覆盖值的有效期见运行时更改。需要持久保存时，使用在配置中编辑持久设置，并查阅配置参考。

更新地理数据或修改来源

按所需操作检查文件可用条件、更新条件和设置条件。

1. 打开地理数据并检查文件。展开详细信息，查看检查时间和下载信息。
2. 要立即下载已配置的来源，点击立即更新并等待结果。
3. 要修改来源，在来源中选择预设，或选择自定义并填写网址。检查缺少分类的警告。在自定义对话框中，点击提供的应用并更新或应用。
4. 按需调整提供的下载路由、SHA-256 校验或自动更新。选择指定组时，还须选择组才会保存路由。这些控件在修改后保存，须检查各次操作结果。
5. 要移除覆盖值，点击重置为默认值，阅读确认提示后再继续。

来源 提供 Loyalsoldier、MetaCubeX 完整版、MetaCubeX 精简版 和 自定义。使用 honk 时，每个自定义 URL 列表最多接受四个地址，按顺序尝试。点 编辑 可重新打开自定义对话框。

详细信息 显示 上次检查、下次检查，以及各文件的大小、下载主机和路由。文件表格显示各文件的更新时间。

持久保存方式见地理数据的存储与生效；下载或生效失败时，参阅地理数据故障排查。

设置手动探测偏好

1. 打开延迟探测。
2. 选择探测方式、IP 版本、连接和策略组探测。
3. 返回节点或组，使用测试按钮。**按选项探测…**可以调整本次测试的选项。

暖探测（复用连接）复用连接；冷探测（新连接）新建连接。策略组探测可选直接成员或含嵌套分组的所有节点。

查看探测要求和结果含义。背景检查使用 在配置中编辑健康检查，字段含义见配置参考。

修改外观

1. 打开外观。
2. 选择语言、配色和明暗模式，按需调整日期格式、时间格式或启动时打开。
3. 使用 Glass 配色时，在背景图片中点击选择图片，或用使用默认恢复内置背景。按需调整提供的遮罩和模糊控件，使文字清晰可读。

日期与时间

• 日期格式默认使用自动（浏览器地区），不受界面语言影响；也可选择日/月/年、月/日/年或年-月-日。
• 时间格式默认为 24 小时制。12 小时制使用界面语言的上午、下午字样；**自动（浏览器地区）**遵循浏览器地区。

这些选择适用于整个界面，包括图表和日志热力图。

布局与启动页面

还可设置 字标、通知位置 和 镜像布局。镜像布局会左右翻转界面。显示国旗 控制节点名称前的国旗，不改变路由。活动卡片显示趋势图 控制流量、CPU 和延迟迷你图。

启动时打开 默认为 活动，修改后立即保存。它只在地址没有页面路由时生效，明确的页面链接仍打开原目标。未配置后端且地址没有页面路由时，会打开 设置。

玻璃配色与壁纸

玻璃配色包括液态玻璃、玻璃、毛玻璃和着色：

• Firefox 和 Safari 将液态玻璃显示为普通玻璃。液态玻璃支持范围见浏览器要求。
• 毛玻璃使用均匀模糊。着色表面接近不透明且不模糊。
• 液态玻璃的事件和日志表格不使用折射和亮边。
• 系统开启减少透明度、增强对比度或强制颜色时，界面使用实色表面。

自定义壁纸也显示在登录页，长边最多缩放至 2560 像素。

控件	默认值或限制
可读性遮罩	默认开启。
淡化	默认及最大值均为 60%；浅色模式使用白色，深色模式使用黑色。
模糊程度	液态玻璃、玻璃和毛玻璃的范围为 0% 到 150%。低于 100% 时会增加表面填充。着色配色没有模糊控件。

浏览器支持和存储条件见浏览器设置。哪些选择属于当前浏览器，见存储位置说明。

万圣节配色

万圣节位于配色列表的其他之下。白昼以南瓜橙搭配羊皮纸底色，午夜以南瓜橙搭配深紫底色。运行中状态显示为闹鬼中，不可用与降级状态显示为中邪。卡片带有淡淡的南瓜灯、蝙蝠、黑猫与蜘蛛网插图，鸭子标志戴上巫师帽。只有选用此配色时才会加载其样式。

查找帮助和错误详情

在关于中，选择指南打开文档，或选择键盘快捷键查看列表。复制最近错误可复制近期 API 错误，供提交错误报告；失败通知中的复制错误则复制该次请求的详情。

关于 doona 显示引擎、API 和契约版本、许可证及隐私声明。支持时会提供 安装为应用；尚未作为应用运行时，iOS/iPadOS 的 Safari 及 macOS 的 Safari 26 或更新版本会显示手动安装步骤。API 主版本不是 1 时会显示警告。

JSON 读取返回空正文或没有收到响应时，会重试一次再显示错误。错误详情包含请求及关键响应头。

查找后端操作

操作	页面与步骤	使用条件
重新加载、挂起或恢复 honk	系统状态	生命周期操作
删除 DNS 缓存条目	DNS	缓存操作
更新订阅	节点	订阅更新
关闭连接	连接	连接操作

写入浏览器中暂存的规则，参阅暂存规则。

---

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