在其他系统上安装

在符合以下内核要求的 x86_64 或 aarch64 Linux 系统上，从发布归档安装 doona 与 honk-core。Alpine 也可使用已签名的 apk 软件包。之后继续阅读最小配置。

说明

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

开始之前

• Linux 6.12 或更高版本，以及系统要求列出的内核选项。用 uname -r 查看内核版本。
• 可使用 sudo 的用户，或 root shell。需要 root 权限的命令分为“sudo”与“root”两个标签页，请选择与当前 shell 相符的一个。
• curl、tar、gzip、sha256sum 与 CA 证书。honk 使用系统 CA 证书校验 HTTPS 下载。在 Alpine 上用 sudo apk add curl ca-certificates 安装，或在 root shell 中执行 apk add curl ca-certificates；其他系统的软件包名称相近。
• 能够访问 github.com。
• 所有步骤都在同一个终端中执行：后面的步骤会用到前面设置的 VERSION、BASE 与 TARGET 变量。

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

在 Alpine 上安装

doona lite 暂无发行版软件包，请使用 lite 压缩包安装步骤。以下软件包命令安装标准版。

Alpine 的 .apk 文件不能与 OpenWrt 的混用。在当前目录下载 Alpine 软件包、发布公钥与校验和：

VERSION=0.1.0-beta.19
BASE=https://github.com/Zakkaus/doona/releases/download/v$VERSION
curl -fL -O "$BASE/doona-${VERSION}-r0.alpine.apk" \
  -O "$BASE/doona-precompressed-${VERSION}-r0.alpine.apk" \
  -O "$BASE/doona-alpine.rsa.pub" -O "$BASE/SHA256SUMS"
grep -E " (doona(-precompressed)?-${VERSION}-r0.alpine.apk|doona-alpine.rsa.pub)\$" SHA256SUMS | sha256sum -c -

每次发布都用新密钥签名软件包。安装公钥时保留名称 doona-alpine.rsa.pub，后续版本会替换它。

sudo wget -O /etc/apk/keys/doona-alpine.rsa.pub "$BASE/doona-alpine.rsa.pub"
sudo apk add ./doona-${VERSION}-r0.alpine.apk ./doona-precompressed-${VERSION}-r0.alpine.apk
ls -l /usr/share/doona/index.html

wget -O /etc/apk/keys/doona-alpine.rsa.pub "$BASE/doona-alpine.rsa.pub"
apk add ./doona-${VERSION}-r0.alpine.apk ./doona-precompressed-${VERSION}-r0.alpine.apk
ls -l /usr/share/doona/index.html

ls 须列出 /usr/share/doona/index.html。可选的 doona-precompressed 为支持预压缩响应的服务器加入 .br 与 .gz 副本；不需要时省略其下载与安装参数。可选字体软件包为 doona-fonts-${VERSION}-r0.alpine.apk。

没有签名公钥时，可用 apk add --allow-untrusted 直接安装文件。安装 honk-core 请从下方第 4 步继续，选择 musl 构建。其余编号步骤说明其他系统的归档安装方式。

1. 下载 doona

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

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

2. 校验下载的文件

该命令适用于 GNU 与 BusyBox 的 sha256sum。

grep " doona-${VERSION}.tar.gz\$" SHA256SUMS | sha256sum -c -

应当显示：

doona-0.1.0-beta.19.tar.gz: OK

3. 安装 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 文件，详见最小配置。

把归档文件解压到 /usr/share/doona，honk 从这个目录提供 doona。

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

sudo mkdir -p /usr/share/doona
sudo tar -xzf doona-${VERSION}.tar.gz -C /usr/share/doona
ls -l /usr/share/doona/index.html

mkdir -p /usr/share/doona
tar -xzf doona-${VERSION}.tar.gz -C /usr/share/doona
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。请继续4. 选择 honk-core 构建，跳过下方的标准版结果说明与可选软件包。在最小配置中，将 ui 设为 /usr/share/doona-lite。

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

ls 输出一行以 /usr/share/doona/index.html 结尾的内容。

可选：字体归档文件为中文界面加入 Noto Sans TC 与 SC 字体。

curl -fL -O "$BASE/doona-fonts-${VERSION}.tar.gz"
grep " doona-fonts-${VERSION}.tar.gz\$" SHA256SUMS | sha256sum -c -
sudo tar -xzf doona-fonts-${VERSION}.tar.gz -C /usr/share/doona

curl -fL -O "$BASE/doona-fonts-${VERSION}.tar.gz"
grep " doona-fonts-${VERSION}.tar.gz\$" SHA256SUMS | sha256sum -c -
tar -xzf doona-fonts-${VERSION}.tar.gz -C /usr/share/doona

可选的 doona-precompressed-${VERSION}.tar.gz 归档在网页文件旁加入 .br 与 .gz 副本，让服务器发送预压缩响应。从同一个发布版本下载并校验，再像字体归档一样解压到 /usr/share/doona。

4. 选择 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。

5. 下载并校验 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

6. 安装 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。

下一步：最小配置。服务相关步骤只涵盖 systemd 与 OpenWrt 的 procd；doona 与 honk 都不提供 OpenRC 脚本。使用 OpenRC 时（例如 Alpine），服务管理给出在前台运行 honk 的命令，用于完成首次登录。

遇到问题时

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