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 の control ファイルのバージョンはリリースごとに増え、プレリリースの識別子には `~` を使うため、後の安定版が正しく並びます。各リリースには、固有のアプリケーション 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)。