doona
为第一条连接设置路由
演示
简体中文

为第一条连接设置路由

从快速启动继续,保持 honk 运行并以管理员身份登录。你需要一个可用的 HTTP 或 HTTPS 订阅 URL,以及网关的 shell 访问权限。本教程将 example.com 送入名为 proxy 的新组,其他流量保持直连。订阅名称使用 harbor。

1. 添加订阅

打开节点页,选择添加订阅。在名称中填写 harbor,在订阅网址中填写供应商的 URL,然后选择添加。doona 会写入声明并请求刷新。

检查成功通知是否显示节点数,再选择 harbor 查看其节点。如果声明已保存但获取失败,先解决报告的错误,再选择卡片上的更新 harbor。订阅包含代理节点后再继续。

控件不可用时,请查阅节点与订阅条件或刷新条件。

2. 创建组

打开策略页,选择新建组。在组名称中填写 proxy,将选择方式设为平均最快。在订阅中选择 harbor,检查匹配的节点后选择创建。

页面应出现 proxy 卡片,其中包含订阅成员。展开卡片,查看所选成员及其延迟或健康状态。组内没有节点时请勿继续。控件不可用时,见组创建与编辑条件。

3. 将测试域名送入组

打开规则 → 路由规则。如果显示视图切换,先选择高级,再选择新建规则。

字段 值
条件写法 选择
依据 完整域名
值 example.com
出站 proxy
插入位置 最后(fallback 之前)

选择对话框中的新建规则,立即写入并重载。检查新规则已生效通知及新增规则:

domain(full: example.com) -> proxy

保留 fallback: direct。添加功能不可用时,见路由规则条件。

4. 定义 DNS 上游

快速启动没有 DNS 区块。打开配置 → 配置文件,在配置文件中选择 /etc/honk/config.dae,将以下区块追加到现有区块之后。保留刚才创建的订阅、组和路由规则。

# 通过代理组发送指定的 DNS 请求。
dns {
    # 使用数字服务器地址,避免依赖其域名的初始解析。
    upstream {
        remote_dns: 'https://1.1.1.1/dns-query' -> proxy
    }
    # 保留其他请求的原目标。
    routing {
        request {
            fallback: asis
        }
    }
}

选择应用,等待文件已写入、配置已重载的通知。重新打开文件,检查 remote_dns 是否存在。编辑器或应用不可用时,见配置写入条件。

5. 添加并应用 DNS 规则

打开规则 → DNS 规则,在request 规则中选择新建规则。将依据设为完整域名,在值中填写 example.com,在动作中选择 remote_dns,将插入位置设为最后(fallback 之前)。

选择新建规则以写入并重载。检查新规则已生效通知及请求规则:

qname(full: example.com) -> remote_dns

两条规则现已应用。路由规则选择流量使用的组;DNS 规则选择解析器,该解析器的请求也经过此组。以上每次保存都会单独生效。添加功能不可用时,见 DNS 规则条件。

6. 用追踪模拟验证规则

在规则页打开追踪模拟。将网络协议设为 TCP,域名填写 example.com,目标端口填写 443。目标 IP留空,在解析模式中选择不解析(none),再选择开始追踪。

结果应匹配你的域名规则,出站为 proxy,节点链中包含 harbor 的节点。改用 example.net 再执行一次,出站应为 direct。追踪只模拟规则评估,不建立连接,也不能证明代理可以访问网站。控件不可用时,见路由追踪条件。

7. 观察真实连接

发出请求前先打开连接页。在网关执行:

curl --http1.1 --limit-rate 32 https://example.com/ -o /dev/null

传输期间,在连接页找到 example.com 并打开对应行。检查节点链是否包含 proxy 和 harbor 的某个节点。短连接可能在查看前已经结束,必要时再次发出请求。传输成功表明此路由能承载真实流量。页面不可用时,见连接条件。

代理流量由用户空间处理,会出现在连接页。直连流量由内核转发,不会出现在该页。使用追踪检查直连回退,或查看配置参考中的完整文件示例。

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。