# 在 OpenWrt 上安裝
在 OpenWrt 路由器上安裝 doona v0.1.0-rc.2 和 honk。所有命令均在路由器的 root shell 中執行，安裝期間保持同一 shell。
## 1. 檢查路由器並準備工具
下載前先檢查[後端前提條件](https://doona.daeuniverse.org/zh-TW/install.md#install)，包括核心、BTF、cgroup 和 CPU 要求。有對應的 doona 套件，不代表路由器可以執行 honk。檢查安裝檔案與下載目錄所需的空間：
```sh
uname -r
uname -m
df -h / /tmp
```
OpenWrt 25.12 使用 apk-tools 3；OpenWrt 24.10 及更早版本使用 opkg 和 ipk 套件。官方 OpenWrt 24.10 使用 [Linux 6.6](https://github.com/openwrt/openwrt/blob/openwrt-24.10/target/linux/x86/Makefile)，低於上文連結中 honk 的最低核心要求。安裝格式相符的 UI 套件不能解決這項相容性問題。
依路由器的套件管理員選擇命令。OpenWrt 提供 [veth 模組](https://github.com/openwrt/openwrt/blob/openwrt-25.12/package/kernel/linux/modules/netsupport.mk)與 [NFQUEUE 模組](https://github.com/openwrt/openwrt/blob/openwrt-25.12/package/kernel/linux/modules/netfilter.mk)套件：
```sh tab="apk"
apk update
apk add curl ca-bundle kmod-veth kmod-nft-queue
```
```sh tab="opkg"
opkg update
opkg install curl ca-bundle kmod-veth kmod-nft-queue
```
啟用了 NFQUEUE，但缺少前提條件時，honk 可能繼續運作，同時停用 NFQUEUE staging 並輸出啟動警告。檢查[服務日誌](https://doona.daeuniverse.org/zh-TW/service-management.md)；服務啟動成功不代表 NFQUEUE staging 已啟用。
## 2. 下載並驗證 doona
以下套件安裝標準版。lite 請使用[手動安裝](https://doona.daeuniverse.org/zh-TW/install-manual.md)中的壓縮檔方式，省略 `sudo`，然後返回第 4 步。
下載至 `/tmp/doona`，依韌體使用的格式選擇套件。OpenWrt apk 套件與 Alpine 套件不同。
`/tmp` 使用記憶體，重新啟動後會清空。下載 honk 時，必須預留同時存放壓縮檔與解壓縮目錄的空間。
```sh
mkdir -p /tmp/doona
cd /tmp/doona
BASE=https://github.com/Zakkaus/doona/releases/download/v0.1.0-rc.2
```
```sh tab="apk"
FILE=doona-0.1.0_rc2-r1.apk
curl -fL -O "$BASE/$FILE" -O "$BASE/doona-openwrt.adb" \
-O "$BASE/doona-openwrt.pem" -O "$BASE/SHA256SUMS"
awk -v file="$FILE" '$2 == file' SHA256SUMS | sha256sum -c -
awk '$2 == "doona-openwrt.adb"' SHA256SUMS | sha256sum -c -
awk '$2 == "doona-openwrt.pem"' SHA256SUMS | sha256sum -c -
```
```sh tab="opkg"
FILE=doona_0.1.0-rc.2-1_all.ipk
curl -fL -O "$BASE/$FILE" -O "$BASE/SHA256SUMS"
awk -v file="$FILE" '$2 == file' SHA256SUMS | sha256sum -c -
```
所有選定檔案都顯示 `OK` 後才能繼續。如果驗證失敗或找不到校驗和項目，先核對檔名並重新下載，再安裝。
下載或執行檔出錯時，見[安裝故障](https://doona.daeuniverse.org/zh-TW/install.md#安裝故障)。
## 3. 安裝套件
使用 apk 時，安裝已驗證的公開金鑰，並透過已簽署的索引安裝。索引與套件檔案應放在同一目錄。
```sh tab="apk"
mkdir -p /etc/apk/keys
cp /tmp/doona/doona-openwrt.pem /etc/apk/keys/doona-openwrt.pem
apk add -X /tmp/doona/doona-openwrt.adb doona
```
```sh tab="opkg"
opkg install "/tmp/doona/$FILE"
```
沒有發行公鑰和索引時，可以直接安裝已驗證的本機 apk：
```sh
apk add --allow-untrusted "/tmp/doona/$FILE"
```
此方式跳過簽章信任檢查，因此使用前必須驗證套件對應的 SHA-256 項目。
```sh
ls -l /usr/share/doona/index.html
```
最後一條命令必須列出 `index.html`。使用[最小設定](https://doona.daeuniverse.org/zh-TW/minimal-configuration.md)中的 OpenWrt 範例時，將 UI 目錄設為 `/usr/share/doona`。
### 選用套件
依需要選擇[選用資源](https://doona.daeuniverse.org/zh-TW/install.md#doona)。將選定檔案下載至 `/tmp/doona`，並如第 2 步使用 `SHA256SUMS` 中對應的項目驗證。
| 套件 | apk 檔名 | opkg 檔名 |
| --- | --- | --- |
| `doona-fonts` | `doona-fonts-0.1.0_rc2-r1.apk` | `doona-fonts_0.1.0-rc.2-1_all.ipk` |
| `doona-precompressed` | `doona-precompressed-0.1.0_rc2-r1.apk` | `doona-precompressed_0.1.0-rc.2-1_all.ipk` |
使用 apk 時，將安裝命令中的 `doona` 改為所選套件名後執行。使用 opkg 時，將 `FILE` 設為所選檔名，再執行安裝命令。
## 4. 安裝 honk
在另一個下載目錄中依照[安裝 honk](https://doona.daeuniverse.org/zh-TW/install.md#install)操作，避免後端的 `SHA256SUMS` 覆蓋 doona 的檔案。選擇 musl 建置版本和 OpenWrt 安裝分頁，將執行檔安裝至 `/usr/bin/honk-core`，再返回本頁。
確認已安裝的執行檔正常後，使用絕對路徑刪除其下載壓縮檔和解壓縮目錄。所有選定的選用 UI 套件安裝完成後，再使用絕對路徑刪除 `/tmp/doona` 中下載的套件、索引、公鑰副本與校驗和檔案。仍需用於安裝的下載檔案應先保留。
## 5. 準備資料目錄
採用[最小設定](https://doona.daeuniverse.org/zh-TW/minimal-configuration.md)中 OpenWrt 範例的持久化目錄配置方式。`data_dir` 的意義見[設定參考](https://doona.daeuniverse.org/zh-TW/configuration.md#config)。
```sh
mkdir -p /etc/honk/config.d /etc/honk/data
chmod 0700 /etc/honk /etc/honk/config.d /etc/honk/data
```
僅在規則需要時下載 geodata，具體條件見 [geodata 要求](https://doona.daeuniverse.org/zh-TW/feature-requirements.md#req-geodata)。採用上述目錄時執行：
```sh
curl -fL --retry 3 -o /etc/honk/data/geosite.dat \
https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/release/geosite.dat
curl -fL --retry 3 -o /etc/honk/data/geoip.dat \
https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/release/geoip.dat
```
也可以安裝發行版提供的 [v2ray geodata 套件](https://github.com/openwrt/packages/blob/openwrt-25.12/net/v2ray-geodata/Makefile)，替代上面的直接下載方式：
```sh tab="apk"
apk add v2ray-geosite v2ray-geoip
```
```sh tab="opkg"
opkg install v2ray-geosite v2ray-geoip
```
honk 會搜尋 `/usr/share/dae`，不會直接搜尋 `/usr/share/v2ray`。先檢查 `/usr/share/dae` 中已有的檔案或連結，僅建立缺少的連結：
```sh
mkdir -p /usr/share/dae
ln -s ../v2ray/geosite.dat /usr/share/dae/geosite.dat
ln -s ../v2ray/geoip.dat /usr/share/dae/geoip.dat
```
已設定的資料目錄中若存在同名檔案，honk 會優先使用這些檔案。
撰寫設定與依照[服務管理](https://doona.daeuniverse.org/zh-TW/service-management.md)建立服務時，使用 OpenWrt 版本的步驟。
## 在 sysupgrade 後保留設定
執行保留設定的一般 sysupgrade 前，將尚未列出的以下路徑加入 `/etc/sysupgrade.conf`，再檢查[備份清單](https://github.com/openwrt/openwrt/blob/openwrt-25.12/package/base-files/files/sbin/sysupgrade)：
```sh
printf '%s\n' '/etc/honk/' '/etc/init.d/honk-core' >> /etc/sysupgrade.conf
sysupgrade -l
```
確認清單包含 honk 設定、資料檔案與 init 指令稿。這份設定備份不會復原已安裝的核心模組、`/usr/bin/honk-core` 或 `/usr/share/doona`。
升級後重複第 1–4 步，重新安裝工具、核心模組、UI 套件和 honk 執行檔。若選用發行版的 geodata 套件，再依照第 5 步重裝並重新建立連結。保留已復原的設定與資料，然後重新啟用並啟動服務：
```sh
/etc/init.d/honk-core enable
/etc/init.d/honk-core start
/etc/init.d/honk-core status
```
檢查[服務日誌](https://doona.daeuniverse.org/zh-TW/service-management.md)，再重複下方快速開始中的 API 檢查。
接著依照[快速開始](https://doona.daeuniverse.org/zh-TW/quick-start.md)設定 honk 並登入。