# Repositori APT Ubuntu / Debian

Repositori Alpha CH-J menerbitkan pakej DEB amd64 rasmi. Ia ditujukan untuk Ubuntu 24.04 dan sistem desktop yang serasi; keserasian dengan setiap keluaran Debian tidak dijamin. Metadata repositori ditandatangani dengan subkunci tandatangan OpenPGP CH-J yang disimpan pada YubiKey. Kunci persendirian tidak pernah dimuat naik ke pelayan web.

## Sahkan kunci dan dayakan repositori

Cap jari utama yang dijangka ialah:

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

Muat turun kunci awam dan semak cap jarinya sebelum memasangnya. Dapatkan cap jari yang dijangka secara bebas daripada README CH-J atau daripada salinan aplikasi yang sudah dipercayai.

```bash
curl -fsSLo ch-j-archive-keyring.gpg https://sm.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
```

Cipta `/etc/apt/sources.list.d/ch-j.sources`:

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

Kemudian pasang:

```bash
sudo apt update
sudo apt install ch-j-server-manager
```

Kemas kini seterusnya menggunakan `sudo apt update` diikuti oleh `sudo apt upgrade`. Versi dalam fail control DEB meningkat bagi setiap keluaran; pengecam pra-keluaran menggunakan `~` supaya versi stabil yang kemudian diisih dengan betul. Setiap keluaran juga mengekalkan Build ID aplikasinya yang unik. Pada masa ini hanya suite alpha mengandungi pakej; beta dan stable mempunyai indeks kosong bertandatangan sehingga keluaran sebenar ditetapkan kepada saluran tersebut. (`alpha`, `beta`, `stable`)

## Panduan dan lesen

APT tidak dapat memaparkan lesen interaktif dengan boleh dipercayai sebelum pemasangan. Pada pelancaran pertama dan selepas kemas kini, aplikasi memaparkan panduan operasi CS/DE/EN yang lengkap, diikuti oleh CH-J Proprietary Software License 1.14 dan kotak semak wajib untuk persetujuan terhadap terma lesen serta notis kehilangan data/sandaran. Menolak lesen atau menutup tetingkapnya akan menutup aplikasi. Panduan operasi kekal bersifat maklumat dan tidak mengikat.

Gunakan APT untuk mengemas kini pemasangan daripada repositori. Jangan jalankan pemasang aplikasi yang berasingan semasa transaksi APT. Pengemas kini dalaman kekal menyokong pemasangan di luar repositori ini.

Metadata repositori menggunakan `InRelease` dan `Release.gpg`, indeks SHA-256/SHA-512 dan indeks beralamat kandungan untuk kemas kini yang konsisten. `Signed-By` mengehadkan kepercayaan kepada repositori ini. Jangan gunakan kepercayaan global `apt-key`. Jangan sekali-kali melumpuhkan pengesahan tandatangan. [Panduan Debian tentang repositori pihak ketiga](https://wiki.debian.org/DebianRepository/UseThirdParty).