Ubuntu / Debian APT 存储库

# Ubuntu / Debian APT 存储库

CH-J 存储库发布 CH-J Tools 的官方 amd64 DEB 软件包（`ch-j-tools`）。它面向 Ubuntu 24.04 及兼容的桌面系统；不保证与所有 Debian 版本兼容。存储库元数据由保存在 YubiKey 上的 CH-J OpenPGP 签名子密钥签名。私钥永远不会上传到 Web 服务器。

## 验证密钥并启用存储库

预期的主指纹为：

```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)。