Debian 软件包注册表

发布您用户或组织的 Debian 软件包。

需求

要使用 Debian 注册表，您需要使用像 curl 这样的 HTTP 客户端来上传，并使用像 apt 这样的包管理器来使用软件包。

以下示例使用 apt。

配置软件包注册表

要注册 Debian 注册表，请将 URL 添加到已知 apt 源列表中。

echo "deb [signed-by=/etc/apt/keyrings/gitea-{owner}.asc] https://gitea.example.com/api/packages/{owner}/debian {distribution} {component}" | sudo tee -a /etc/apt/sources.list.d/gitea.list

占位符	描述
所有者	软件包的所有者。
发行版	要使用的发行版。
组件	要使用的组件。

如果注册表是私有的，请在 URL 中提供凭据。您可以使用密码或 个人访问令牌

echo "deb [signed-by=/etc/apt/keyrings/gitea-{owner}.asc] https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/debian {distribution} {component}" | sudo tee -a /etc/apt/sources.list.d/gitea.list

Debian 注册表文件使用 PGP 密钥进行签名，该密钥必须为 apt 所知。

sudo curl https://gitea.example.com/api/packages/{owner}/debian/repository.key -o /etc/apt/keyrings/gitea-{owner}.asc

之后更新本地软件包索引。

apt update

发布软件包

要发布 Debian 软件包（*.deb），请使用请求正文中的软件包内容执行 HTTP PUT 操作。

PUT https://gitea.example.com/api/packages/{owner}/debian/pool/{distribution}/{component}/upload

参数	描述
所有者	软件包的所有者。
发行版	发行版可能与操作系统的版本名称匹配，例如：bionic。
组件	组件可用于对软件包进行分组，或者仅使用 main 或类似名称。

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_password_or_token \
     --upload-file path/to/file.deb \
     https://gitea.example.com/api/packages/testuser/debian/pool/bionic/main/upload

如果您使用的是 2FA 或 OAuth，请使用 个人访问令牌 而不是密码。

如果已存在具有相同名称、版本、发行版、组件和体系结构的软件包，则您无法发布软件包。您必须先删除现有的软件包。

服务器将返回以下 HTTP 状态代码。

HTTP 状态代码	含义
201 已创建	软件包已发布。
400 错误请求	软件包无效。
409 冲突	已存在具有相同参数组合的软件包文件。

删除软件包

要删除 Debian 软件包，请执行 HTTP DELETE 操作。如果不再有文件，这也会删除软件包版本。

DELETE https://gitea.example.com/api/packages/{owner}/debian/pool/{distribution}/{component}/{package_name}/{package_version}/{architecture}

参数	描述
所有者	软件包的所有者。
软件包名称	软件包名称。
软件包版本	软件包版本。
发行版	软件包发行版。
组件	软件包组件。
架构	软件包架构。

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_token_or_password -X DELETE \
     https://gitea.example.com/api/packages/testuser/debian/pools/bionic/main/test-package/1.0.0/amd64

服务器将返回以下 HTTP 状态代码。

HTTP 状态代码	含义
204 无内容	成功
404 未找到	未找到软件包或文件。

安装软件包

要从 Debian 注册表安装软件包，请执行以下命令。

# use latest version
apt install {package_name}
# use specific version
apt install {package_name}={package_version}