مخزن APT برای Ubuntu / Debian

# مخزن APT برای Ubuntu / Debian

مخزن CH-J بستهٔ رسمی DEB برای amd64 از CH-J Tools (`ch-j-tools`) را منتشر می‌کند. این مخزن برای Ubuntu 24.04 و سیستم‌های دسکتاپ سازگار در نظر گرفته شده است؛ سازگاری با همهٔ نسخه‌های Debian تضمین نمی‌شود. فرادادهٔ مخزن با زیرکلید امضای OpenPGP متعلق به CH-J که روی یک 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` استفاده می‌کنند. نسخه در فایل control بستهٔ 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).