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