엔터프라이즈 Qt 데비안 패키지

Qt와 함께 엔터프라이즈 데비안 패키지를 사용하려면, Advanced Packaging Tool(APT)에 엔터프라이즈 저장소를 추가하십시오. 자세한 내용은 데비안 저장소 구성 형식을 참조하십시오.

엔터프라이즈 저장소를 사용하려면 다음을 수행해야 합니다.

엔터프라이즈 저장소용공개 GPG 키 설치
엔터프라이즈 저장소 액세스를 위한Qt 계정 기반 인증 구성
리포지토리 구성

참고: 자세한 내용 및 지원이필요하시면 당사에 문의해 주십시오. 무료 체험판에 대한 자세한 내용은 Qt 소프트웨어 무료 체험판을 참조하십시오.

데비안 저장소 구성 형식

APT용 리포지토리를 추가하려면 /etc/apt/sources.list.d 디렉터리 내에 .list 확장자를 가진 파일에 리포지토리를 입력하십시오. 각 리포지토리마다 파일에 새로운 항목을 추가해야 합니다. 일반적인 형식은 다음과 같습니다:

deb [arch=<arch> signed-by=<path>] <REPO_URL> <DIST> <COMPONENT(s)>

엔터프라이즈 저장소 항목의 예:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

Qt 릴리스별 및 아키텍처별로 저장소를 구성하는 방법에 대한 자세한 내용은 Qt 릴리스용 저장소 정보를 참조하십시오.

데비안 소스 패키지

APT용 데비안 소스 패키지를 추가하려면 해당 deb 항목에 대한 deb-src 항목을 추가해야 합니다:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main
    deb-src [signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

소스 패키지(예: wayland)를 현재 디렉터리에 다운로드하려면 apt source 명령을 사용하십시오:

$ sudo apt source qt-6.12.0-wayland-src

공개 GPG 키 설치

Enterprise Qt Debian 저장소에 대한 공개 GPG(GNU Privacy Guard) 키를 다음과 같이 설치하십시오:

$ sudo mkdir -p /etc/apt/keyrings/tqtc  # Create the directory with appropriate permissions
$ cd /etc/apt/keyrings/tqtc
$ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

인증 구성

나열된 저장소에 액세스하려면 엔터프라이즈 Qt 계정 또는 평가용 Qt 계정이 필요합니다.

참고: 비밀번호에 특수 문자가 포함된경우 , '\' 또는 '%40'을 사용하여 해당 문자를 이스케이프 처리해야 할 수 있습니다 .

APT 패키지 관리자를 위해 Qt 계정 자격 증명을 다음과 같이 구성하십시오:

$ sudo nano /etc/apt/auth.conf

      machine https://debian-packages.qt.io
      login <Qt Account login name (email)>
      password <Qt Account password>

경고: 이 파일에는 민감한 정보가 포함되어 있을 수 있습니다. 시스템의 다른 사용자가 비밀번호를 읽지 못하도록 하려면, 파일에 엄격한 권한이 설정되어 있는지 확인하십시오:

$ sudo chmod 600 /etc/apt/auth.conf

로컬 패키지 캐시 업데이트

다음과 같이 로컬 패키지 캐시를 업데이트하십시오:

$ sudo apt-get update

출력 결과에 추가된 저장소로 인한 오류가 나타나지 않아야 합니다.

데비안 별칭 패키지

실제 Debian 패키지를 가리키는 메타 패키지인 별칭 패키지를 사용하면 콘텐츠를 더 쉽게 설치할 수 있습니다.

Debian 별칭 패키지의 내용은 아래 표에 나열되어 있습니다.

참고: 아래에 나열된 별칭 패키지 예제에서는Qt 6.12.0 릴리스가 사용됩니다. 작업 중인 Qt 릴리스와 일치하는 패키지를 사용해야 한다는 점을 항상 기억하십시오. 자세한 내용은 Qt 릴리스에 대한 저장소 정보를 참조하십시오.

별칭 패키지 이름	패키지 내용
qt6.12.0-essentials	필수 모듈 라이브러리 필수 모듈 런타임 도구
qt6.12.0-essentials-dev	필수 모듈 라이브러리 필수 모듈 헤더 필수 모듈 비공개 헤더 필수 모듈 런타임 도구 필수 모듈 개발 도구
qt6.12.0-full	필수 모듈 라이브러리 필수 모듈 런타임 도구 추가 모듈 라이브러리 애드온 모듈 런타임 도구
qt6.12.0-full-dev	모든 모듈 라이브러리 모든 모듈 헤더 모든 모듈의 비공개 헤더 모든 모듈 런타임 도구 모든 모듈 개발 도구
qt6.12.0-full-dbg	모든 모듈 디버그 라이브러리 필수 모듈 라이브러리 애드온 모듈 라이브러리

Debian 설치 명령어 예시

$ sudo apt install qt6.12.0-full-dev

전체 구성 예시

다음 코드 예제는 Enterprise Qt 데비안 패키지를 사용한 전체 작업 흐름을 보여줍니다:

 # install repository key
 $ sudo mkdir -p /etc/apt/keyrings/tqtc
 $ cd /etc/apt/keyrings/tqtc
 $ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

 # configure Qt Account based authentication to Qt Debian repositories
 $ sudo nano /etc/apt/auth.conf
   machine https://debian-packages.qt.io
   login <your Qt Account email>
   password <your Qt Account password>

 # add repositories
 $ sudo nano /etc/apt/sources.list.d/tqtc.list
     deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt6.12.0-arm64 tqtc-jammy main

 # add source packages
 $ sudo nano /etc/apt/sources.list.d/tqtc.list
     deb-src [signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

 # update local package cache
 $ sudo apt-get update

 # search and install packages
 $ apt-cache search qt6.12.0-full-dev
 ....
 ....
 # files are installed under /opt/qt-6.12.0
$ sudo apt install qt6.12.0-full-dev

Qt 릴리스에 대한 저장소 정보를 참조하여 필요한 저장소를 /etc/apt/sources.list.d/tqtc.list 파일에 추가하십시오.

문제 해결

인증 문제

서버에서 다음과 같은 HTTP 오류 코드를 반환할 수 있습니다:

401 Unauthorized

인증 정보가 잘못되었습니다. 사용자 이메일과 비밀번호는 올바른 형식으로 입력해야 합니다.

또한, 자격 증명을 리포지토리 구성 파일에 직접 저장해 보십시오:

deb [...] https://<Qt Account email>:<Qt Account passwd>@https://debian-packages.qt.io/.....

비밀번호에 특수 문자가 포함된 경우, APT에서 해당 문자를 이스케이프 처리해야 할 수 있습니다. 해당 문자를 이스케이프 처리하려면 '' 또는 '%40'을 사용하거나, Qt 계정 비밀번호를 변경해 보십시오.

403 접근 금지

인증 정보가 누락되었습니다.

429 요청 과다

사용자가 실패한 요청을 너무 많이 보냈습니다(분당 3회).

500 내부 서버 오류

Qt 지원팀에 문의하십시오.

저장소 GPG 키 사용 관련 문제

리포지토리 구성에서 ` signed-by ` 사용 속성을 대체하는 방법으로, 다음과 같은 방식으로 키를 설치할 수 있습니다. 단, 이는 더 이상 권장되지 않는 설치 방식이므로 권장하지 않습니다:

$ sudo apt-key add qt-company-debian-repo.gpg

Qt 릴리스에 대한 저장소 정보

아래에서 Enterprise Qt Debian 패키지가 지원하는 Qt 릴리스를 확인할 수 있습니다. 필요한 저장소를 선택하고 위에서 안내한 대로 /etc/apt/sources.list.d/tqtc.list 파일에 추가하십시오.

또한, 다음 표에는 시스템의 설치 디렉터리와 해당 패키지와 호환되는 리눅스 배포판이 나열되어 있습니다.

참고: 나열된 저장소에액세스하려면 평가용 Qt 계정 또는 Qt for Device Creation 라이선스가 포함된 상용 Qt 계정이 필요합니다.

참고: 이 패키지들은 다른 배포판에서도 작동할 수 있지만, 이에 대한 보장은 없습니다.

Qt Creator

아키텍처	배포판	설치 디렉터리	APT용 패키지 리소스 목록 항목
amd64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-creator/	deb [arch=amd64 signed-by=<경로>] https://debian-packages.qt.io/debian/enterprise/qtcreator-amd64 tqtc-jammy main
arm64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-creator/	deb [arch=arm64 signed-by=<경로>] https://debian-packages.qt.io/debian/enterprise/qtcreator-arm64 tqtc-jammy main

Qt 6.12.0

아키텍처	배포판	설치 디렉터리	APT용 패키지 리소스 목록 항목
amd64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-6.12.0/x86_64-linux-gnu/	deb [arch=amd64 signed-by=<경로>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-amd64 tqtc-jammy main
arm64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-6.12.0/aarch64-linux-gnu/	deb [arch=arm64 signed-by=<경로>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main
arm64	bookworm (Debian 12, GLES)	/opt/qt-6.12.0/aarch64-linux-gnu/	deb [arch=arm64 signed-by=<경로>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64-gles tqtc-bookworm main

특정 문제 Wayland 및 Qt

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.