APT-репозиторий для Ubuntu / Debian

# APT-репозиторий для Ubuntu / Debian

Репозиторий CH-J публикует официальный пакет DEB для amd64 приложения CH-J Tools (`ch-j-tools`). Он предназначен для Ubuntu 24.04 и совместимых настольных систем; совместимость со всеми выпусками Debian не гарантируется. Метаданные репозитория подписаны подключом подписи CH-J OpenPGP, который хранится на YubiKey. Закрытый ключ никогда не загружается на веб-сервер.

## Проверка ключа и подключение репозитория

Ожидаемый отпечаток основного ключа:

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

Скачайте открытый ключ и проверьте его отпечаток перед установкой. Получите ожидаемый отпечаток независимо — из README CH-J или из уже доверенной копии приложения.

```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 увеличивается с каждым выпуском; идентификаторы предварительных версий используют `~`, чтобы более поздняя стабильная версия правильно сортировалась. Каждый выпуск также сохраняет свой уникальный идентификатор сборки приложения.

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