在 Fedora 或 RHEL 上安装

在 Fedora、RHEL 或其他使用 DNF 的系统上，从 .rpm 软件包安装 doona，并从同一个发布版本安装 honk-core。之后继续阅读最小配置。

说明

从发布页下载 beta.19 附件。

开始之前

• Linux 6.12 或更高版本，以及系统要求列出的内核选项。用 uname -r 查看内核版本。
• 可使用 sudo 的用户，或 root shell。需要 root 权限的命令分为“sudo”与“root”两个标签页，请选择与当前 shell 相符的一个。
• 能够访问 github.com。
• 所有步骤都在同一个终端中执行：后面的步骤会用到前面设置的 VERSION、BASE 与 TARGET 变量。

安装 lite 时，请先确保 curl 与 CA 证书已安装，再直接前往4. 安装 doona，选择 doona lite 标签页。此前的标准版软件包、仓库、下载与校验步骤均可跳过。

1. 安装 curl 与 CA 证书

honk 使用系统 CA 证书校验通过 HTTPS 下载的订阅与地理数据。

sudo dnf install curl ca-certificates

dnf install curl ca-certificates

2. 下载 doona

设置发布版本号，然后把软件包与校验和文件下载到当前目录。

VERSION=0.1.0-beta.19
BASE=https://github.com/Zakkaus/doona/releases/download/v$VERSION
curl -fL -O "$BASE/doona-${VERSION}-1.noarch.rpm" -O "$BASE/SHA256SUMS"

3. 校验下载的文件

grep " doona-${VERSION}-1.noarch.rpm\$" SHA256SUMS | sha256sum -c -

应当显示：

doona-0.1.0-beta.19-1.noarch.rpm: OK

4. 安装 doona

设置 ui: embedded 时，doona beta.19 的 honk debug.2026.10.9.native-api.2 附件（提交 eac5e0c5fba5078a7ff4517a3e3851e7fa0f4f8e）提供内置的 doona 0.1.0-beta.19，无需单独安装界面软件包。也可以设置 ui: /usr/share/doona，提供此处安装的 beta.19 软件包，详见最小配置。

doona lite 使用压缩包，暂不提供发行版软件包。请按安装 doona lite操作，设置 ui: /usr/share/doona-lite，然后继续本页的 honk 步骤。选择所需版本与 shell 对应的标签页。

sudo dnf install ./doona-${VERSION}-1.noarch.rpm
ls -l /usr/share/doona/index.html

dnf install ./doona-${VERSION}-1.noarch.rpm
ls -l /usr/share/doona/index.html

VERSION=0.1.0-beta.19
BASE=https://github.com/Zakkaus/doona/releases/download/v$VERSION
curl -fL -O "$BASE/doona-lite-${VERSION}.tar.gz" -O "$BASE/SHA256SUMS"
grep " doona-lite-${VERSION}.tar.gz\$" SHA256SUMS | sha256sum -c -
sudo mkdir -p /usr/share/doona-lite
sudo tar -xzf "doona-lite-${VERSION}.tar.gz" -C /usr/share/doona-lite
ls -l /usr/share/doona-lite/index.html

VERSION=0.1.0-beta.19
BASE=https://github.com/Zakkaus/doona/releases/download/v$VERSION
curl -fL -O "$BASE/doona-lite-${VERSION}.tar.gz" -O "$BASE/SHA256SUMS"
grep " doona-lite-${VERSION}.tar.gz\$" SHA256SUMS | sha256sum -c -
mkdir -p /usr/share/doona-lite
tar -xzf "doona-lite-${VERSION}.tar.gz" -C /usr/share/doona-lite
ls -l /usr/share/doona-lite/index.html

安装 lite 后，ls 须列出 /usr/share/doona-lite/index.html。请继续5. 选择 honk-core 构建，跳过下方的标准版结果说明与可选软件包。在最小配置中，将 ui 设为 /usr/share/doona-lite。

以下为标准版的结果与可选组件：

发布的 RPM 未签名；第 3 步在安装前校验其校验和。ls 输出一行以 /usr/share/doona/index.html 结尾的内容。该软件包只包含 doona 的网页文件与文档，不安装任何服务。

可选的 doona-precompressed 软件包在网页文件旁加入 .br 与 .gz 副本，让服务器发送预压缩响应。须与 doona 安装相同版本；不安装时主软件包保持不变。

可选：doona-fonts 软件包为中文界面加入 Noto Sans TC 与 SC 字体。

curl -fL -O "$BASE/doona-fonts-${VERSION}-1.noarch.rpm"
grep " doona-fonts-${VERSION}-1.noarch.rpm\$" SHA256SUMS | sha256sum -c -
sudo dnf install ./doona-fonts-${VERSION}-1.noarch.rpm

curl -fL -O "$BASE/doona-fonts-${VERSION}-1.noarch.rpm"
grep " doona-fonts-${VERSION}-1.noarch.rpm\$" SHA256SUMS | sha256sum -c -
dnf install ./doona-fonts-${VERSION}-1.noarch.rpm

5. 选择 honk-core 构建

uname -m

发布版本附带 8 个 honk-core 归档文件，名称为 honk-core-debug-<target>.tar.gz。根据机器类型与 C 库确定 target：

例如 x86_64-unknown-linux-musl、aarch64-unknown-linux-gnu 或 x86_64-unknown-linux-musl-stock。

6. 下载并校验 honk-core

把 TARGET 设为所选的构建，然后从同一个发布版本下载，并用同一个 SHA256SUMS 校验。

TARGET=x86_64-unknown-linux-musl
curl -fL -O "$BASE/honk-core-debug-$TARGET.tar.gz"
grep " honk-core-debug-$TARGET.tar.gz\$" SHA256SUMS | sha256sum -c -

应当显示：

honk-core-debug-x86_64-unknown-linux-musl.tar.gz: OK

7. 安装 honk-core

归档文件内有一个目录，其中包含 honk-core 二进制文件。把它安装为 /usr/local/bin/honk-core，即服务管理中的服务启动的路径。

tar -xzf honk-core-debug-$TARGET.tar.gz
sudo install -m 0755 honk-core-debug-$TARGET/honk-core /usr/local/bin/honk-core
/usr/local/bin/honk-core --version

tar -xzf honk-core-debug-$TARGET.tar.gz
install -m 0755 honk-core-debug-$TARGET/honk-core /usr/local/bin/honk-core
/usr/local/bin/honk-core --version

最后一条命令输出 honk 的构建版本，例如：

honk-core debug.2026.10.9.native-api.2

同一个发布版本中的 HONK-SOURCE.txt 记录 honk 构建，并提供 honk 源码与对应 doona 源码的链接。

首次启动 honk 前，请按目录与地理数据安装 geosite.dat 与 geoip.dat。

下一步：最小配置。

遇到问题时

安装后遇到的问题请参阅故障排查。