在其他系統上安裝

本頁在沒有 doona 套件、符合核心要求的 x86_64 或 aarch64 Linux 系統（例如 Alpine Linux）上，用發行版本中的封存檔安裝 doona 與 honk-core。完成最後一步後，請繼續閱讀最小組態。

開始之前

Linux 6.12 或更高版本，以及系統需求列出的核心選項。用 uname -r 檢視核心版本。
可使用 sudo 的使用者，或 root shell。需要 root 權限的命令分為「sudo」與「root」兩個分頁，請選擇與目前的 shell 相符的一個。
curl、tar、gzip、sha256sum 與 CA 憑證。缺少 CA 憑證時 honk 會在啟動階段結束。在 Alpine 上用 sudo apk add curl ca-certificates 安裝，或在 root shell 中執行 apk add curl ca-certificates；其他系統的套件名稱相近。
能夠連線到 github.com。
所有步驟都在同一個終端機中執行：後面的步驟會用到前面設定的 VERSION、BASE 與 TARGET 變數。

1. 下載 doona

設定發行版本號，然後把程式封存檔與總和檢查碼檔案下載到目前目錄。

VERSION=0.1.0-beta.12
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.12.tar.gz: OK

3. 安裝 doona

使用 doona 0.1.0-beta.12 附帶的 honk-core 建置並設定 ui: embedded 時，doona 套件可省略，詳見最小組態。

把封存檔解壓縮到 /usr/share/doona，honk 從這個目錄提供 doona。

sudo

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

root

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

ls 輸出一行以 /usr/share/doona/index.html 結尾的內容。

可選：字型封存檔為中文介面加入 Noto Sans TC 與 SC 字型。

sudo

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

root

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

4. 選擇 honk-core 建置

uname -m

發行版本附帶 8 個 honk-core 封存檔，名稱為 honk-core-debug-<target>.tar.gz。根據機器類型與 C 函式庫確定 target：

`uname -m` 輸出	target 開頭
`x86_64`	`x86_64-unknown-linux-`
`aarch64`	`aarch64-unknown-linux-`

target 結尾	適用情況
`musl`	無法確定，或系統使用 musl（例如 Alpine）時選擇此項。靜態連結，不受系統 glibc 版本限制。
`gnu`	系統的 glibc 為 2.39 或更高版本。glibc 較舊時會顯示錯誤 `GLIBC_2.38' not found` 並結束。
`-stock` 後綴	記憶體比速度更重要，例如小型裝置。使用系統記憶體分配器而不是 mimalloc。

例如 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，即服務管理中的服務啟動的路徑。

sudo

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

root

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.9.30.native-api.5

同一個發行版本中的 HONK-SOURCE.txt 註明其附帶的建置。

下一步：最小組態。服務相關步驟只涵蓋 systemd 與 OpenWrt 的 procd；doona 與 honk 都不提供 OpenRC 指令碼。使用 OpenRC 時（例如 Alpine），服務管理提供在前景運作 honk 的命令，用於完成首次登入。

遇到問題時

看到的內容	原因與處理
`curl: (22) The requested URL returned error: 404`	版本號或檔名有誤。請對照發布頁面檢查 `VERSION`。
`no properly formatted checksum lines found`（GNU）或 `no checksum lines found`（BusyBox）	`grep` 沒有找到該檔案對應的行：目前的終端機未設定 `VERSION` 或 `TARGET`，或其中有拼字錯誤。
`FAILED` 以及驗證和不匹配的 `WARNING`	下載的檔案損壞或不完整。刪除該檔案後重新下載。
`sha256sum: unrecognized option: ignore-missing`	BusyBox 沒有 `--ignore-missing` 選項。請使用第 2 步的 `grep` 寫法。
`version 'GLIBC_2.38' not found`	`gnu` 建置需要更新的 glibc。請改用 `musl` 建置。

安裝後遇到的問題請參閱疑難排解。