单独安装 doona

不使用 honk 内嵌的 doona 时，可单独安装界面文件。内嵌界面的操作见快速入门。

选择系统

系统	指南
Debian 或 Ubuntu	安装 deb
Fedora 或 RHEL	安装 RPM
Arch Linux	通过 pacman 安装
Gentoo	通过 Portage 安装
OpenWrt	在路由器上手动安装
Alpine 或其他 Linux 发行版	安装压缩包或 Alpine 软件包

这些软件包只安装静态网页文件。请另行安装、配置并启动后端。版本选择见标准版与 lite。

安装界面文件与兼容的 honk 后，将以下块加入 honk 配置，替换原有的 native_api 块：

dae

experimental {
    native_api {
        enabled: true
        listen: '127.0.0.1:9527'
        password_auth: true
        config_write: true
        ui: '/usr/share/doona'
    }
}

请使用软件包中包含 index.html 的目录；Debian 与 Ubuntu 使用 /usr/share/doona-web。手动解压时，请改用解压目录。详见界面文件、其他 API 选项及其他来源与反向代理。

安装 honk

先检查 honk 指南中的内核与主机要求。首次启动时保留控制台访问方式。下载前准备好 curl、CA 证书、tar 和 sha256sum。

1. 选择并下载后端构建

打开 honk 发布页，选择适合网关的 full 或 native-api 压缩包，并复制下载链接。clash-api 版本无法提供 doona 所需的原生 API。后端有独立的版本号，不要用 doona 的版本号拼接 honk 下载地址。

uname -m

选项	选择方法
CPU	按 `uname -m` 的结果选择 `x86_64` 或 `aarch64`。
C 库	网关使用静态链接的 `musl` 构建，包括 OpenWrt 和 Alpine。
API 版本	`full` 包含原生 API 和嵌入式 UI；`native-api` 可提供单独安装的 UI 文件。
内存分配器	`-stock` 使用系统分配器；不带此后缀的构建使用 mimalloc。

在网关上的新下载目录中执行以下命令，并在提示后粘贴压缩包的下载链接：

printf 'honk archive URL: '
read -r HONK_URL

在同一 shell 中下载压缩包与该次发布的校验和文件：

HONK_ARCHIVE=${HONK_URL##*/}
curl -fL -O "$HONK_URL" -O "${HONK_URL%/*}/SHA256SUMS"

2. 校验并解压

awk -v file="$HONK_ARCHIVE" '$2 == file' SHA256SUMS | sha256sum -c -

所有选定文件都显示 OK 后才能继续。如果校验失败或找不到校验和条目，先核对文件名并重新下载，再安装。

tar -xzf "$HONK_ARCHIVE"
HONK_PACKAGE=${HONK_ARCHIVE%.tar.gz}

3. 安装可执行文件

首次安装时选择适合当前 shell 的标签页。更新现有安装时，先按服务管理停止服务，再替换可执行文件。

sudorootOpenWrt

sudo install -d /usr/local/bin
sudo install -m 0755 "$HONK_PACKAGE/honk-core" /usr/local/bin/honk-core
/usr/local/bin/honk-core --version

install -d /usr/local/bin
install -m 0755 "$HONK_PACKAGE/honk-core" /usr/local/bin/honk-core
/usr/local/bin/honk-core --version

cp "$PWD/$HONK_PACKAGE/honk-core" /usr/bin/honk-core
chmod 0755 /usr/bin/honk-core
/usr/bin/honk-core --version

确认版本命令成功执行。保留下载的发布版本名称，供日后核对。

更新时保留现有配置，并重启服务。确认启动日志显示已安装的引擎版本。

从发行版指南进入本节的读者，请返回原页继续。

改用源码构建

先按 honk 源码构建指南准备工具链、构建 eBPF 并检查 BTF。在 honk 仓库根目录，将最后的 honk-core 构建命令替换为：

cargo build --release -p honk-core --features ebpf,native-api

ebpf 提供实际数据路径，native-api 提供 doona 所需的 API。将 target/release/honk-core 安装到上文的可执行文件路径。发布的可执行文件已嵌入 eBPF 对象，无需单独安装对象文件。

安装故障

错误	处理方法
下载时返回 HTTP 404	核对发布标签和完整文件名。从对应发布页复制下载链接，不要自行拼接未经核实的文件名。
启动 honk 时出现 `GLIBC_* not found`	所选 gnu 构建需要更新的 glibc。改用 honk 发布页中对应的静态 musl 构建。
BusyBox 拒绝 `--ignore-missing`	BusyBox `sha256sum` 不支持该选项。使用这些安装指南中的逐文件 `awk` 和 `sha256sum -c -` 命令，确认选定文件显示 `OK`。

按规则需要安装 geodata

添加 Geo 规则前，先检查 geodata 要求。

使用配置中指定的数据目录。采用 systemd 指南中的 /var/lib/honk 布局时，执行：

sudo install -d -m 0700 /var/lib/honk
sudo curl -fL --retry 3 -o /var/lib/honk/geosite.dat \
  https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/release/geosite.dat
sudo curl -fL --retry 3 -o /var/lib/honk/geoip.dat \
  https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/release/geoip.dat

使用 root shell 时省略 sudo。OpenWrt 请使用对应的 geodata 步骤。后续更新及其条件见 geodata 更新。

安装 UI 文件

按本页列出的发行版指南或手动安装操作。将包含 index.html 的目录用于 ui 配置项：

安装方式	UI 目录
Debian 或 Ubuntu 软件包	`/usr/share/doona-web`
其他软件包或标准版压缩包安装步骤	`/usr/share/doona`
lite 压缩包安装步骤	`/usr/share/doona-lite`

可选资源

资源	用途
`doona-fonts`	标准版使用的 Noto Sans TC 和 SC 字体。
`doona-precompressed`	在标准版文件旁添加 `.br` 和 `.gz` 副本，供支持预压缩资源的服务器使用。版本应与主包一致。

Debian 的软件包名称为 doona-web-fonts 和 doona-web-precompressed。软件包文件名见各发行版页面；压缩包安装步骤见手动安装。

预压缩资源会额外占用磁盘空间，存储空间有限的路由器可不安装。未安装可选字体压缩包时，doona 使用后备字体，不加载可选字体文件。但仍会请求 fonts/README，检测是否已安装字体压缩包。

本地构建与打包文件

仓库提供 OpenWrt、Alpine、Gentoo 和 Nix 打包文件，尚未提交到这些发行版的仓库。AUR 的 doona-bin 打包文件在独立仓库中维护。

需要安装到暂存目录时，先完成本地构建，再从 doona 仓库根目录执行以下命令，将 /absolute/staging/path 替换为暂存目录。两个目标都支持 DESTDIR 和 PREFIX；不需要字体时省略第二条命令。

make install DESTDIR=/absolute/staging/path PREFIX=/usr
make install-fonts DESTDIR=/absolute/staging/path PREFIX=/usr

UI 文件会安装到暂存目录下的 usr/share/doona。

通过其他地址提供 UI

监听地址、UI 目录、Host 和 Origin 的配置见原生 API 设置。使用主机名或反向代理前，检查登录要求。

主机名与静态资源 403 错误

使用 http://owrt.lan:9527/ui/ 时，在现有 experimental.native_api 块内添加以下条目，保留其他设置与允许列表条目：

dae

allowed_hosts: 'owrt.lan:9527'
allow_origins: 'http://owrt.lan:9527'

allowed_hosts 填主机名和端口，不带协议或路径。allow_origins 填协议、主机名和端口，不带路径或末尾斜杠。多个条目分别加引号，再用逗号分隔，例如 allowed_hosts: 'owrt.lan:9527', 'router.lan:9527'。不要使用 JSON 方括号，也不要用一对引号包住整个列表。允许 Host 不会自动允许其 Origin。

如果 HTML 能打开，但 JavaScript 或 CSS 返回 403，在浏览器开发者工具的网络面板中检查失败的请求。将 Host、Origin 及其端口与允许列表逐项比较。修改后重启 honk，再重新加载页面。

静态服务器与反向代理

静态服务器可以在网站根目录或 /ui/ 等路径前缀下提供解压后的 UI 文件。doona 使用 /ui/#/activity 这样的 hash 路由，无需配置 SPA 重写规则。

反向代理必须将精确路径 /api 的 discovery 请求和 /api/ 下的请求都转发到 honk 监听地址。只转发 /api/ 会遗漏 discovery，导致无法连接。

如果连接地址带有 /gateway 等代理前缀，将 /gateway/api 转发到 honk 的 /api，将 /gateway/api/… 转发到 /api/…。两个路由必须采用相同的前缀映射。

维护安装

重新加载或重启

先查doona 可以更改什么，确定修改如何生效，再执行服务管理中的命令。

更新 UI

使用外部 UI 目录时，沿用原安装方式安装新版软件包或压缩包。在已配置的目录中替换文件后，只需重新加载浏览器页面。

使用 ui: embedded 时，安装独立 UI 软件包不会替换嵌入式界面。可以按安装 honk更新到包含新版 UI 的 honk 构建，也可以单独安装 UI 文件，再将 ui 改为对应目录。两种方式都需要重启 honk，然后重新加载浏览器页面。

安装界面文件后，应用本页开头的配置，重启 honk，再按首次登录操作。

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

单独安装 doona ​

选择系统 ​

安装 honk ​

1. 选择并下载后端构建 ​

2. 校验并解压 ​

3. 安装可执行文件 ​

改用源码构建 ​

安装故障 ​

按规则需要安装 geodata ​

安装 UI 文件 ​

可选资源 ​

本地构建与打包文件 ​

通过其他地址提供 UI ​

主机名与静态资源 403 错误 ​

静态服务器与反向代理 ​

维护安装 ​

重新加载或重启 ​

更新 UI ​