Ubuntu / Debian APT 存放庫

# Ubuntu / Debian APT 存放庫

CH-J 存放庫發布 CH-J Tools 的官方 amd64 DEB 套件（`ch-j-tools`）。它適用於 Ubuntu 24.04 及相容的桌面系統；不保證與所有 Debian 版本相容。存放庫中繼資料以保存在 YubiKey 上的 CH-J OpenPGP 簽署子金鑰簽署。私密金鑰絕不會上傳到網頁伺服器。

## 驗證金鑰並啟用存放庫

預期的主要指紋為：

```text
0D92 778A D8EC F85C 80E3 9248 48F2 433A D9CD F453
```

下載公開金鑰，並在安裝前檢查其指紋。請透過獨立管道取得預期的指紋，例如 CH-J README 或已受信任的應用程式副本。

```bash
curl -fsSLo ch-j-archive-keyring.gpg https://tools.ch-j.cz/apt/ch-j-archive-keyring.gpg
gpg --show-keys --with-fingerprint ch-j-archive-keyring.gpg
sudo install -d -m 0755 /etc/apt/keyrings
sudo install -m 0644 ch-j-archive-keyring.gpg /etc/apt/keyrings/ch-j-archive-keyring.gpg
```

建立 `/etc/apt/sources.list.d/ch-j.sources`：

```text
Types: deb
URIs: https://tools.ch-j.cz/apt/
Suites: beta
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/ch-j-archive-keyring.gpg
```

接著安裝：

```bash
sudo apt update
sudo apt install ch-j-tools
```

如果您曾從此存放庫安裝較早的 `ch-j-server-manager` 套件，請將 `Suites` 改為 `beta` 並執行相同的命令。`ch-j-tools` 會取代舊套件，應用程式會在首次啟動時移動其資料資料夾。

之後的更新請先執行 `sudo apt update`，再執行 `sudo apt upgrade`。DEB 控制檔中的版本號會隨每次發行遞增；預先發行識別碼使用 `~`，以確保之後的穩定版本能正確排序。每次發行也都保有其唯一的應用程式 Build ID。

| `alpha` | `beta` | `stable` |
| --- | --- | --- |
| `ch-j-server-manager` 0.1.1 | `ch-j-tools` 0.1.2 | — |

## 指南與授權條款

APT 無法在安裝前可靠地顯示互動式授權條款。首次啟動及每次更新後，應用程式會顯示完整的 CS/DE/EN 作業指南，接著顯示 CH-J Proprietary Software License 1.14，並要求勾選必要的核取方塊，以確認授權條款以及資料遺失/備份提醒。拒絕授權條款或關閉其視窗會結束應用程式。作業指南仍僅供參考，不具約束力。

透過存放庫安裝的版本請使用 APT 更新。APT 交易進行期間，請勿啟動應用程式的獨立安裝程式。對於未透過此存放庫安裝的版本，內建的更新程式仍持續支援。

存放庫中繼資料使用 `InRelease` 與 `Release.gpg`、SHA-256/SHA-512 索引，以及依內容定址的索引，以確保更新一致。`Signed-By` 會將信任範圍限定於此存放庫。請勿使用全域的 `apt-key` 信任。絕對不要停用簽章驗證。[Debian 第三方存放庫指南](https://wiki.debian.org/DebianRepository/UseThirdParty)。