Kho APT cho Ubuntu / Debian

# Kho APT cho Ubuntu / Debian

Kho CH-J phát hành gói DEB amd64 chính thức của CH-J Tools (`ch-j-tools`). Kho này dành cho Ubuntu 24.04 và các hệ thống máy tính tương thích; khả năng tương thích với mọi bản phát hành Debian không được bảo đảm. Siêu dữ liệu của kho được ký bằng khóa con ký OpenPGP của CH-J được lưu trên YubiKey. Khóa riêng tư không bao giờ được tải lên máy chủ web.

## Xác minh khóa và bật kho

Dấu vân tay chính mong đợi là:

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

Tải khóa công khai và kiểm tra dấu vân tay của nó trước khi cài đặt. Hãy lấy dấu vân tay mong đợi một cách độc lập từ README của CH-J hoặc từ một bản sao ứng dụng đã được tin cậy.

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

Tạo `/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
```

Sau đó cài đặt:

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

Nếu bạn đã cài gói cũ `ch-j-server-manager` từ kho này, hãy đổi `Suites` thành `beta` và chạy cùng các lệnh. `ch-j-tools` thay thế gói cũ, và ứng dụng sẽ di chuyển thư mục dữ liệu của mình trong lần khởi động đầu tiên.

Các lần cập nhật sau dùng `sudo apt update`, tiếp theo là `sudo apt upgrade`. Phiên bản trong tệp control của DEB tăng lên ở mỗi bản phát hành; định danh tiền phát hành dùng `~` để phiên bản ổn định sau đó được sắp xếp đúng thứ tự. Mỗi bản phát hành cũng giữ Build ID ứng dụng duy nhất của nó.

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

## Hướng dẫn và giấy phép

APT không thể hiển thị giấy phép tương tác một cách đáng tin cậy trước khi cài đặt. Ở lần khởi chạy đầu tiên và sau khi cập nhật, ứng dụng hiển thị toàn bộ hướng dẫn vận hành CS/DE/EN, tiếp theo là CH-J Proprietary Software License 1.14 và một ô đánh dấu bắt buộc để đồng ý với các điều khoản giấy phép cũng như thông báo về mất dữ liệu/sao lưu. Từ chối giấy phép hoặc đóng cửa sổ của nó sẽ thoát ứng dụng. Hướng dẫn vận hành vẫn chỉ mang tính thông tin và không ràng buộc.

Hãy dùng APT để cập nhật bản cài đặt từ kho. Không chạy trình cài đặt riêng của ứng dụng trong khi giao dịch APT đang diễn ra. Trình cập nhật nội bộ vẫn hỗ trợ các bản cài đặt không đến từ kho này.

Siêu dữ liệu của kho dùng `InRelease` và `Release.gpg`, chỉ mục SHA-256/SHA-512 và chỉ mục theo địa chỉ nội dung để cập nhật nhất quán. `Signed-By` giới hạn độ tin cậy chỉ cho kho này. Không dùng cơ chế tin cậy toàn cục `apt-key`. Tuyệt đối không tắt xác minh chữ ký. [Hướng dẫn của Debian về kho của bên thứ ba](https://wiki.debian.org/DebianRepository/UseThirdParty).