配置与设置

本页说明「配置」页：在此查看、校验并应用 honk 的配置文件。本页也说明「设置」页：在此管理连接方案、后端选项、地理数据、外观与后端操作。

打开「配置」页

在「设置」分区中打开「配置」。只有后端提供配置内容时才显示此页面。
查看标签页上方的一行信息。「配置版本」标识当前生效的配置，内容变更并生效后会改变。旁边的状态显示「没有诊断」，或错误与警告的数量。
若该行还显示「后端已脱敏监听密钥的值」，表示后端在返回的文本中隐藏了这些值。
选择标签页：「模块」「快速设置」「来源」或「校验」。只有主配置可写入时才显示「快速设置」，见下文「快速设置」一节。

页面默认打开「模块」。后端未返回主配置文本时打开「来源」；主配置为空且可使用「快速设置」时打开「快速设置」。配置文件格式以及主配置与引入文件的作用，见配置说明。

来源

打开「来源」，从「来源」下拉列表选择文件。每一项都标出文件类型：「主配置」「引入文件」「订阅」或「引擎生成」。
下拉列表旁显示文件的行数与大小。将指针悬停在上面可查看加载时间。
文件不可编辑时，下拉列表旁会显示标记，说明原因。各标记的含义见下表。
点击「导出」可下载显示的文本。导出文件保留显示的原始文本，可能包含凭据，分享前须检查。

标记	含义
「只读」	后端未开放写入配置；标记旁的说明给出启用方法，配置说明介绍 `config_write`。若没有该说明，表示后端拒绝写入此文件且未给出原因，见只读配置文件。
「含密钥」	文件含监听密钥，后端不会写回。将密钥移到独立的引入文件后，即可编辑其余内容。
「未返回内容」	后端未返回此文件的文本。请检查后端的内容可见性策略。
「内容已脱敏」	后端隐藏了文件的部分内容，写回会丢失这些值。
「订阅」	文件从订阅地址下载，更新订阅时会被替换。
「引擎生成」	文件由引擎生成，重新生成时会被覆盖。如需修改，请修改生成它的配置。

在只读文件中输入内容时，页面会提示一次「此文件只读」。

编辑并应用来源

在「来源」中选择没有标记的文件，点击其文本。
输入修改。页面显示「未应用」标记；此时重新加载或关闭页面会丢失修改。
若后端支持校验，doona 会在停止输入片刻后校验主配置及其引入文件，并在编辑器中标出有诊断的行。点击「校验」可立即校验，光标会移到第一个错误。
检查编辑器上方的诊断列表。点击某一行的「打开来源」，可打开对应文件并定位到该行。
点击「应用」。honk 校验文件、写入修改并重载配置。页面提示文件已写入、配置已重载。

点击「取消」可放弃修改。校验发现错误时不会写入任何内容，错误显示在列表中。若修改涉及需重启才生效的设置，同样不会写入；请在文件中修改该设置，再重启 honk。

若编辑期间磁盘上的文件已更改，页面会显示提示，「应用」不可用。点击「保留修改」后再点击「应用」，可用你的文本覆盖新文件；点击「取消」则放弃修改并加载新文本。

新建引入文件：

在「来源」中点击「新建文件」。后端允许创建文件时才显示此按钮。
若主配置的 include 路径模式已决定目录与扩展名，只需在「名称」中输入文件名；有多个路径模式时，先在「路径模式」中选择。否则在「路径」中输入相对于主配置目录的路径，路径须以 .dae 结尾。
点击「创建」。新文件内容为空，配置随即重载，并在「来源」中打开该文件。

若已加载文件的 include 路径模式都不匹配该路径，对话框会提示后端将拒绝创建。

校验与诊断

打开「校验」。状态显示「通过」「通过，N 个警告」，或「未通过」及错误与警告的数量。
使用「全部」「错误」「警告」或「提示」筛选表格。每一行显示「级别」「位置」「消息」与「代码」。
选中一行，点击「打开来源」，可打开对应文件并定位到该行。
点击「重新校验」可校验当前文件。

尚未校验时，表格显示生效配置保留的诊断，并标出其 generation。校验后，表格显示该次校验的时间；配置重载或应用修改后，表格恢复显示生效配置的诊断。校验涵盖主配置及其引入文件，需要主配置的完整文本。若仍有错误，「应用」不会写入文件，重载也不会应用配置。

模块

打开「模块」。每个 global、subscription、node、group、dns 与 routing 区段各显示一张卡片，列出所在文件、行范围与摘要。
点击卡片上的「编辑」，可直接编辑该区段。只有文件可写入且文本完整时才显示「编辑」。
如有「校验」可先点击，再点击「应用」；点击「取消」可放弃修改。

同一时间只能编辑一个区段。「打开来源文件」会在「来源」中打开整个文件并定位到该区段。「打开页面」会打开管理该区段的页面：「节点」「策略」，或「规则」页的 DNS 列表与路由列表。未设置的区段会显示提示；若可以在主配置中添加该区段，提示会给出主配置的文件名。

快速设置

后端开放写入配置、主配置可写入且返回了完整文本时，才显示「快速设置」。

打开「快速设置」。在「订阅」下为每个订阅填写「名称」与「订阅网址」，点击「添加订阅」可增加一行。
在「规则」中保持「保留当前规则」可让 routing 区段保持不变，也可以选择「ACL4SSR Mini 分组」「ACL4SSR Online 分组（默认）」或「ACL4SSR Full 分组」。
若主配置为空，还须填写「透明代理端口」「默认 DNS 上游」与「中国大陆域名 DNS 上游」。「LAN 接口」可不填。
检查「生成的配置」，然后点击「应用」。主配置的写入与「来源」相同，经过校验和重载。

「应用」会改写主配置的 subscription 区段。选用模板时，还会替换所有顶层 routing 区段并补上缺少的 group，其余内容保持不变。应用后，页面显示前往「节点」「策略」「路由规则」与「打开来源」的链接。

「设置」页

在「设置」分区中打开「设置」。未连接后端时也能打开此页面，因此可以在此修正后端网址。卡片按以下顺序排列：

「后端」
「后端选项」
「地理数据」，仅在后端允许配置地理数据来源时显示
「外观」
「后端操作」
「关于」

后端

在「连接方案」中选择连接方案即可切换。doona 保存选择后重新加载页面，连接该后端。
使用「新建连接方案」「重命名连接方案」或「删除连接方案」管理连接方案。每项操作都会打开对话框，确认后页面重新加载。新建的连接方案默认使用内置演示数据。
填写「后端网址」：后端的根网址或反向代理前缀，不是 /api/v1。留空或填写 mock 可使用内置演示数据。
填写「Token」。使用密码登录的后端会显示说明而非此字段；登录后会显示「退出登录」。
点击「测试连接」。结果显示「连接成功，API vN」，或说明失败原因。
点击「保存」。doona 将连接方案保存在此浏览器中，并重新加载页面以应用该方案。

切换、新建、重命名或删除连接方案都会放弃尚未保存的「后端网址」与「Token」修改；对话框会事先提示。配对链接会填入「后端网址」与「Token」，保存后生效。「保存」修改的是 doona 的连接方案，不是 honk 的配置。测试连接或登录失败时，见登录失败。

后端选项

查看标题旁的标记：「配置值」或「运行时覆盖」。
修改后端提供的字段：「日志级别」「日志保留条数」「DNS 记录保留条数」「流程保留条数」与「流程保留秒数」。每个数值字段都显示允许的范围。
「流程记录」可选择「按流程需求」「常开」或「关闭」。「日志记录」与「DNS 记录」可选择「随面板」「常开」或「关闭」。每项旁的状态显示「记录中」「未记录」或「配置禁止」。
点击「应用」，修改立即生效。有未应用的修改时会显示「放弃修改」。

这些选项不会写入配置文件。重启或已接受的显式配置激活（包括没有内容变化的重载）会恢复配置文件中的值。激活被拒绝、订阅或网络刷新时，覆盖值保持不变。配置中禁止的记录功能不能在此启用。若编辑期间后端选项已更改，doona 会保留草稿并给出提示。

地理数据

只有后端允许配置地理数据来源时才显示「地理数据」卡片。若后端提供地理数据但不允许配置其来源，「后端操作」卡片会列出地理数据文件，见后端操作。

选择「来源」：「Loyalsoldier」「MetaCubeX 完整版」「MetaCubeX 精简版」或「自定义」。若预设缺少规则使用的分类，切换前会弹出对话框列出这些分类，因为后端更新时会拒绝这类文件。
选择「自定义」时，在「自定义网址」对话框中填写 geosite 与 geoip 的网址，然后点击「应用并更新」或「应用」。每种数据最多 4 个网址，按顺序尝试。请填写直接返回文件的网址；GitHub Releases 下载链接会重定向，无法使用。之后可点击「编辑」重新打开对话框。
选择「下载路由」：「按路由规则」「直连」或「指定组」。选择「指定组」后还须选择组，选定后路由才会保存。
除非可信镜像的校验地址返回错误页面或 HTTP 404 以外的错误，否则保持开启「SHA-256 校验」。镜像未提供 .sha256sum 文件时，文件本来就会不经校验直接加载。
开启「自动更新」并选择「更新间隔（小时）」，即可定时下载。
查看「状态」。如有「立即更新」，点击即可立即下载。展开「详细信息」可查看每个文件的信息。

每个控件修改后立即保存。后端支持手动更新时，更换来源后随即下载新文件；否则在下次自动更新时下载。只有后端提供相应信息时，才显示「下载路由」与「SHA-256 校验」。若卡片提示网址来自配置文件，honk 重启时会再次写入这些网址。更新失败时，见地理数据更新失败与地理数据来源。

外观

可选择「语言」「配色」「明暗模式」「字标」与「通知位置」。开启「镜像布局」可将布局左右翻转。doona 将这些选项保存在此浏览器中，不会修改 honk 的配置。

后端操作

此卡片只显示后端支持的操作。

在「服务」下点击「重载」，honk 会重新读取配置文件。引擎运行时显示「暂停」，暂停后显示「恢复」。
在「DNS」下点击「清除全部缓存」并确认，可清除全部 DNS 缓存项。
在「节点」下点击「刷新全部订阅（N）」。
在「连接」下点击「全部关闭」并确认。此操作关闭后端持有的全部连接，并跳过内核直连的连接。
后端提供地理数据但无法配置其来源时，「地理数据」表格列出每个文件的「数据」「大小」「更新」「SHA-256」与「来源」。如有「更新」，点击后会下载并校验文件，然后重载配置。

顶部栏的「重载 honk」经确认后执行同样的重载，见界面导览。两者都不会写入暂存的规则，见暂存规则。若地理数据说明提示下载网址来自配置文件，则在此编辑来源需要后端的状态数据库，见状态数据库。

关于

「关于 doona」会打开对话框，显示引擎、API 与契约版本、许可证和隐私说明。「键盘快捷键」会打开快捷键列表。「指南」会以界面语言打开本文档。浏览器提供安装功能时显示「安装为应用」；iOS 与 macOS 上的 Safari 则显示安装步骤。若后端的 API 主版本不是 1，此卡片会显示警告。