doona
常见操作
演示
简体中文

常见操作

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

从现有连接让一个网站经过代理

  1. 打开「观测」>「连接」,选择「连接」标签页。
  2. 在列表中找到访问该网站的连接。
  3. 点击该行的新建规则图标,打开「新建规则」对话框。
  4. 将「依据」设为「完整域名」。
  5. 将「出站」设为代理组。对话框会显示该连接当前的出站和规则预览。
  6. 检查「插入位置」。若对话框提示「前面的规则仍可能先命中此流量。」,改选更靠前的位置。
  7. 点击「应用」立即写入规则并重载;或点击「暂存」,稍后通过顶部栏带有规则数量的应用按钮写入。

点击「应用」后,提示显示「新规则已生效」。在「规则」模式下,若没有更靠前的规则先命中,匹配的新连接会使用新出站;现有连接重新连接后才改用新路由。此对话框没有「锁定此出站」,因此「全局」或「直连」模式仍会覆盖这条规则;如需在这两种模式下保留该路由,请在「路由」>「规则」中添加规则并开启「锁定此出站」。暂存规则见暂存列表,对话框各字段见新建规则。

让一个域名及其子域名经过指定组

  1. 打开「路由」>「规则」,选择「路由规则」标签页。若显示视图切换选项,先选择「高级」。
  2. 点击「新建规则」。对话框打开时,「条件写法」为「选择」。
  3. 将「依据」设为「域名后缀」,在「值」中输入域名。多个域名以逗号分隔。
  4. 将「出站」设为目标组。
  5. 若全局或直连模式下也须按此规则转发,开启「锁定此出站」。
  6. 将「插入位置」设在可能先命中同一流量的规则之前。
  7. 点击对话框中的「新建规则」。

doona 将规则写入其来源文件并重载。提示显示「新规则已生效」;现有连接重新连接后才改用新路由。详见路由、节点与规则。

让一台设备不经过代理

规则按设备的来源 IP 地址匹配,因此设备需要固定地址。

  1. 在「路由」>「规则」打开「路由规则」标签页。有视图切换选项时,选择「高级」。
  2. 点击列表上方的「新建规则」。
  3. 将「依据」设为「来源 IP」,在「值」中输入设备的 IP 地址。
  4. 将「出站」设为 direct。
  5. 开启「锁定此出站」,使全局模式不会改写此规则。
  6. 将「插入位置」设在可能先命中该地址的规则之前。
  7. 点击对话框中的「新建规则」提交此设备规则。

写入后,该地址的新连接改走 direct,现有连接重新连接后才改用新路由。详见规则对话框。

为组选择节点并恢复自动选择

  1. 打开「路由」>「策略」。
  2. 找到该组的卡片。
  3. 在卡片的节点网格中选择节点。提示会确认选择结果:节点被固定时,提示说明自动策略已暂停;否则说明现有连接已保留或已中断。
  4. 若提示说明已手动固定该节点且自动策略已暂停,打开卡片的「更多操作」菜单,点击「恢复自动选择」。

点击「恢复自动选择」后,提示会显示该组当前使用的成员;详见策略组。

添加并刷新订阅

  1. 打开「路由」>「节点」。
  2. 点击「节点来源」卡片上方的「添加订阅」,打开对话框。
  3. 填写「名称」和「订阅网址」,点击「添加」。
  4. 之后如需更新,点击该订阅卡片上的更新按钮。

点击「添加」后,doona 会选中新卡片。后端支持刷新订阅时,doona 会立即刷新,并在提示中显示节点数量或失败原因。详见来源与节点。

切换到全局模式并选择出站

  1. 打开「活动」。
  2. 在「出站模式」卡片中选择「全局」。
  3. 在「全局出站」卡片中选择出站。
  4. 点击「出站模式」卡片中的「应用」。

doona 将模式和出站写入主配置并重载,提示会确认新的出站模式。详见观测流量。

查明连接为何使用某个出站

  1. 打开「观测」>「连接」,选择「连接」标签页,再选择该连接。
  2. 在详情面板中查看「出站」「链」和「规则」。
  3. 如需打开命中的规则,打开详情面板的「更多操作」,点击「查看命中的规则」。「路由」>「规则」页面会打开并选中该规则。
  4. 如需测试路由,打开「更多操作」,点击「追踪此连接」。「追踪模拟」会打开,并已填入该连接的信息。
  5. 点击「开始追踪」。

追踪按当前配置模拟路由,不会重放该连接。详见观测流量与路由、节点与规则。

查看域名如何解析

  1. 打开「观测」>「DNS」,选择「查询」标签页。
  2. 在「域名」中输入域名,选择「类型」。提供「上游」时,保留「自动」以遵循 dns.routing,或选择 dns.upstream 中的上游。点击「查询」。
  3. 在结果卡片中查看缓存状态、「状态」「上游」「路由来源」「路由规则」「耗时」和应答。
  4. 如需查看此前的解析,选择「解析记录」标签页,再选择一行查看详情。

结果字段与记录控件的说明见 DNS 指南。

更新地理数据

  1. 打开「设置」>「设置」。
  2. 「地理数据」卡片提供「立即更新」时,点击「状态」旁的该按钮。卡片也列出地理数据文件。

更新操作下载文件,启用校验时验证校验和。内容有变化时替换对应文件并重载配置;内容相同的文件不会重写。所有内容均未变化时,更新成功但不激活或重载。提示显示操作结果。「重置为默认值」经确认后移除地理数据覆盖值与来自配置文件的值,恢复内置来源与默认值。详见配置与设置与故障排查。

在 doona 外修改文件后重载 honk

  1. 在顶部栏点击「重载 honk」。窄屏下,打开「更多选项」,点击「重载 honk」。
  2. 在「重载 honk?」对话框中点击「重载 honk」。

honk 会重新读取配置文件并重载,暂存的规则不会写入。需要重启才生效的设置,须等 honk 重启后才生效,详见配置。顶部栏的说明见界面导览。

处理编辑期间磁盘上已更改的文件

  1. 打开「设置」>「配置」,选择「配置文件」标签页。
  2. 在「配置文件」中选择该文件。若开始编辑后磁盘上的文件已更改,页面会显示提示,并禁用「应用」。
  3. 如需保留磁盘上的更改,点击「取消」。草稿会被丢弃,编辑器显示文件的当前内容。
  4. 如需用草稿覆盖磁盘上的更改,点击「保留修改」,再点击「应用」。

「保留修改」不会合并两个版本;「应用」会用草稿覆盖文件。详见配置与设置。

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。