企业版 Qt Debian 软件包

若要使用 Qt 配合企业版 Debian 软件包，请将您的企业版软件源添加到高级打包工具 (APT) 中。详情请参阅《Debian 软件源配置格式》。

要使用企业软件源，您需要：

安装企业软件源的公钥
配置基于 Qt 账户的身份验证以访问企业软件源
配置软件源

注意：如需 更多详细信息和支持，请联系我们。有关免费试用的更多信息，请参阅Qt 软件免费试用。

Debian 软件源配置格式

要为 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 版本的软件源信息。

Debian 源代码包

若要为 APT 添加 Debian 源代码包，您需要为相应的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

安装公钥

请按以下步骤为企业版 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 软件包的元软件包。

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 Debian 软件包的完整工作流程：

 # 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 未授权

凭据错误。用户的电子邮件和密码必须以正确的格式提供。

此外，请尝试将凭据直接存储在仓库配置中：

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中。

此外，下表列出了系统上的安装目录以及与这些软件包兼容的 Linux 发行版。

注意：要 访问所列存储库，您需要一个 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.