删除和恢复软件包

GitHub 上对软件包删除和恢复的支持

在 GitHub 上，如果您拥有所需访问权限，您可以删除

整个私有软件包
整个公共软件包（前提是该软件包的任何版本的下载次数不超过 5000 次）
私有软件包的特定版本
公共软件包的特定版本（前提是该版本的下载次数不超过 5,000 次）

注意

如果软件包的任何版本下载次数超过 5,000 次，则无法删除公共软件包。在此情况下，请通过 GitHub 支持门户与我们联系，以获得进一步帮助。
删除公共软件包时，请注意可能会破坏依赖该软件包的项目。

在 GitHub 上，您也可以在满足以下条件时恢复整个软件包或软件包版本，

在删除后 30 天内恢复软件包。
相同的软件包命名空间仍然可用且未被新软件包占用。

软件包 API 支持

注意

GitHub Packages 仅支持使用个人访问令牌（经典版）进行身份验证。欲了解更多信息，请参阅管理您的个人访问令牌。

您可以使用 REST API 来管理软件包。更多信息请参阅软件包的 REST API 端点。

注意

GitHub Actions 工作流使用 REST API 删除和恢复软件包的功能目前处于公开预览阶段，可能会有变更。

对于支持细粒度权限的注册表，您可以在 GitHub Actions 工作流中使用 GITHUB_TOKEN 通过 REST API 删除或恢复软件包。该令牌必须拥有对软件包的 admin 权限。如果您的工作流发布了软件包，admin 角色会默认授予存放工作流的仓库。对于未通过工作流发布的已有软件包，您需要授予该仓库 admin 角色，才能使用 GitHub Actions 工作流通过 REST API 删除或恢复软件包。更多信息请参阅配置软件包的访问控制和可见性。

对于某些注册表，您可以使用 GraphQL 删除私有软件包的某个版本。

您不能在支持细粒度权限的注册表中使用 GitHub Packages GraphQL API。对于仅 支持仓库范围权限 且可使用 GraphQL API 的注册表，请参阅 GitHub 软件包权限概述。

删除或恢复软件包所需的权限

对于支持细粒度权限的注册表，您可以选择将软件包限定在用户、组织或关联到仓库。

要删除具有细粒度权限且独立于仓库的软件包，例如存储在 https://ghcr.io/NAMESPACE/PACKAGE-NAME 的容器镜像或存储在 https://npm.pkg.github.com/NAMESPACE/PACKAGE-NAME 的软件包（其中 NAMESPACE 为软件包所属的个人账户或组织名称），您必须拥有该软件包的管理员访问权限。更多信息请参阅 GitHub 软件包权限概述。

对于从仓库继承访问权限的软件包，只要您拥有该仓库的管理员权限即可删除软件包。

某些注册表仅支持仓库范围的软件包。有关这些注册表的列表，请参阅 GitHub 软件包权限概述。

删除软件包版本

在 GitHub 上删除仓库范围软件包的版本

要删除仓库范围软件包的某个版本，您必须拥有发布该软件包的仓库的管理员权限。更多信息请参阅所需权限。

在 GitHub 上，导航至仓库的主页面。
在仓库的右侧边栏，点击 Packages（软件包）。
搜索并点击您想要管理的软件包名称。
在“最近版本”列表下，点击 查看并管理所有版本。
在软件包列表中，找到您想要删除的版本。
- 如果您的软件包是容器，在软件包版本右侧点击，然后在下拉菜单中选择 删除版本。
- 对于非容器类型的软件包，在软件包版本右侧点击删除。
确认删除时，输入软件包名称并点击 我已了解后果，删除此版本。

使用 GraphQL 删除仓库范围软件包的版本

对于某些注册表，您可以使用 GraphQL 删除私有软件包的某个版本。

您无法在支持细粒度权限的注册表中使用 GitHub Packages GraphQL API。对于仅 支持仓库范围权限 且可使用 GraphQL API 的注册表，请参阅 GitHub 软件包权限概述。如需改用 REST API 的信息，请参阅软件包的 REST API 端点。

在 GraphQL API 中使用 deletePackageVersion 变更。您必须使用具有 read:packages、delete:packages 和 repo 范围的个人访问令牌（经典）。有关个人访问令牌（经典）的更多信息，请参阅 GitHub 软件包简介。

以下示例演示如何删除软件包版本，使用的 packageVersionId 为 MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg。

curl -X POST \
-H "Accept: application/vnd.github.package-deletes-preview+json" \
-H "Authorization: bearer TOKEN" \
-d '{"query":"mutation { deletePackageVersion(input:{packageVersionId:\"MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg==\"}) { success }}"}' \
HOSTNAME/graphql

要查找您在 GitHub Packages 发布的所有私有软件包及其版本 ID，您可以通过 repository 对象使用 packages 连接。您需要拥有 read:packages 和 repo 范围的个人访问令牌（经典）。更多信息请参阅 packages 连接或 PackageOwner 接口。

有关 deletePackageVersion 变更的更多信息，请参阅变更。

您不能直接使用 GraphQL 删除整个软件包，但如果删除软件包的所有版本，GitHub 上将不再显示该软件包。

在 GitHub 上删除用户范围软件包的版本

要在 GitHub 上删除用户范围软件包的特定版本，例如位于 ghcr.io 的 Docker 镜像，请按以下步骤操作。如需删除整个软件包，请参阅在 GitHub 上删除整个用户范围软件包。

要了解谁可以删除软件包版本，请参阅所需权限。

在 GitHub 上，导航到您个人账户的主页。
在 GitHub 右上角，单击您的个人资料图片，然后单击 您的个人资料。
在您的个人资料页面的页眉，单击 软件包 选项卡。
搜索并点击您想要管理的软件包名称。
在“最近版本”列表下，点击 查看并管理所有版本。
在软件包列表中，找到您想要删除的版本。
- 如果您的软件包是容器，在软件包版本右侧点击，然后在下拉菜单中选择 删除版本。
- 对于非容器类型的软件包，在软件包版本右侧点击删除。
在确认框中输入软件包名称，以确认您要删除其所选的版本。
点击 我已了解后果，删除此版本。

在 GitHub 上删除组织范围软件包的版本

要在 GitHub 上删除组织范围软件包的特定版本，例如位于 ghcr.io 的 Docker 镜像，请按以下步骤操作。如需删除整个软件包，请参阅在 GitHub 上删除整个组织范围软件包。

要了解谁可以删除软件包版本，请参阅删除或恢复软件包的所需权限。

在 GitHub 上，前往您组织的主页。
在组织名称下，点击 软件包 选项卡。
搜索并点击您想要管理的软件包名称。
在“最近版本”列表下，点击 查看并管理所有版本。
在软件包列表中，找到您想要删除的版本。
- 如果您的软件包是容器，在软件包版本右侧点击，然后在下拉菜单中选择 删除版本。
- 对于非容器类型的软件包，在软件包版本右侧点击删除。
在确认框中输入软件包名称，以确认您要删除其所选的版本。
点击 我已了解后果，删除此版本。

删除整个软件包

在 GitHub 上删除整个仓库范围软件包

要删除整个仓库范围软件包，您必须拥有拥有该软件包的仓库的管理员权限。更多信息请参阅所需权限。

在 GitHub 上，导航至仓库的主页面。
在仓库的右侧边栏，点击 Packages（软件包）。
搜索并点击您想要管理的软件包名称。
在软件包的登录页面右侧，点击 软件包设置。
在页面底部的“危险区域”下，点击 删除此软件包。
确认时，检查确认信息，输入软件包名称，然后点击 我已了解，删除此软件包。

在 GitHub 上删除整个用户范围软件包

要了解谁可以删除软件包，请参阅所需权限。

在 GitHub 上，导航到您个人账户的主页。
在 GitHub 右上角，单击您的个人资料图片，然后单击 您的个人资料。
在您的个人资料页面的页眉，单击 软件包 选项卡。
搜索并点击您想要管理的软件包名称。
在软件包的登录页面右侧，点击 软件包设置。
在页面底部的“危险区域”下，点击 删除此软件包。
在确认框中输入软件包名称，以确认您要删除它。
点击 我已了解后果，删除此软件包。

在 GitHub 上删除整个组织范围软件包

要了解谁可以删除软件包，请参阅所需权限。

在 GitHub 上，前往您组织的主页。
在组织名称下，点击 软件包 选项卡。
搜索并点击您想要管理的软件包名称。
在软件包的登录页面右侧，点击 软件包设置。
在页面底部的“危险区域”下，点击 删除此软件包。
在确认框中输入软件包名称，以确认您要删除它。
点击 我已了解后果，删除此软件包。

恢复软件包

如果满足以下条件，您可以恢复已删除的软件包或版本：

在删除后 30 天内恢复软件包。
相同的软件包命名空间和版本仍然可用且未被新软件包重新使用。

例如，如果您是用户 octocat，并且有一个已删除的 RubyGems 软件包 my-package，其范围限定在仓库 octocat/my-repo，则只有在软件包命名空间 rubygem.pkg.github.com/octocat/my-repo/my-package 仍然可用且未超过 30 天的情况下，才能恢复该软件包。

要恢复已删除的软件包，您还必须满足以下权限要求之一：