# 在 Debian 或 Ubuntu 上安裝

使用系統套件管理員安裝 doona v0.1.0-rc.2 標準版。doona lite 請依照[壓縮檔安裝說明](https://doona.daeuniverse.org/zh-TW/install-manual.md)操作。

在閘道器上開啟終端機，進入新建的下載目錄，並在同一 shell 中完成各步。使用 root shell 時省略 `sudo`。安裝後端前先檢查 [honk 的前提條件](https://doona.daeuniverse.org/zh-TW/install.md#install)。

## 1. 準備下載工具

```sh tab="sudo"
sudo apt update
sudo apt install curl ca-certificates
```

```sh tab="root"
apt update
apt install curl ca-certificates
```

## 2. 下載並驗證套件

從 [v0.1.0-rc.2 發行頁](https://github.com/Zakkaus/doona/releases/tag/v0.1.0-rc.2)下載：

```sh
BASE=https://github.com/Zakkaus/doona/releases/download/v0.1.0-rc.2
FILE=doona-web_0.1.0-rc.2-1_all.deb
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. 安裝網頁檔案

```sh
sudo apt install "./$FILE"
ls -l /usr/share/doona-web/index.html
```

最後一條命令必須列出 `/usr/share/doona-web/index.html`。依照[最小設定](https://doona.daeuniverse.org/zh-TW/minimal-configuration.md)操作時，將 UI 目錄設為 `/usr/share/doona-web`；對應的設定項目是 [`ui`](https://doona.daeuniverse.org/zh-TW/configuration.md#config)。

Debian 套件名為 `doona-web`。不要改用 `apt install doona`，Debian 和 Ubuntu 中的這個名稱屬於另一個套件。

### 復原被 Debian 同名套件替換的 UI

如果 `apt upgrade` 將舊 `doona` 網頁套件替換成無關的網路模糊測試工具，導致 UI 消失：

1. 依照上文安裝已驗證的 `doona-web`，需要字型時再依照下文安裝 `doona-web-fonts`。新套件宣告替換或衝突的舊網頁套件版本範圍為低於 1.0。
2. 將現有 [`ui` 設定項目](https://doona.daeuniverse.org/zh-TW/configuration.md#config)改為 `/usr/share/doona-web`，再[重新啟動 honk](https://doona.daeuniverse.org/zh-TW/service-management.md)並重新載入瀏覽器頁面。
3. 如果仍安裝了無關的 `doona`，執行 `sudo apt remove doona`。這會保留 `doona-web`。

### 選用套件

是否需要字型或預先壓縮的檔案，見[選用資源](https://doona.daeuniverse.org/zh-TW/install.md#doona)。安裝時在下列命令中將 `FILE` 設為表中對應的檔名。範例選擇字型套件。

| 資源 | 檔名 |
| --- | --- |
| 字型 | `doona-web-fonts_0.1.0-rc.2-1_all.deb` |
| 預先壓縮的檔案 | `doona-web-precompressed_0.1.0-rc.2-1_all.deb` |

```sh
FILE=doona-web-fonts_0.1.0-rc.2-1_all.deb
curl -fL -O "$BASE/$FILE"
awk -v file="$FILE" '$2 == file' SHA256SUMS | sha256sum -c - &&
  sudo apt install "./$FILE"
```

## 4. 安裝後端

依照[安裝 honk](https://doona.daeuniverse.org/zh-TW/install.md#install)安裝後端後返回本頁。已有相容的 honk 時無需重複安裝。

接著依照[快速開始](https://doona.daeuniverse.org/zh-TW/quick-start.md)設定 honk 並登入。