非市场扩展

安装不在 Marketplace 中提供的扩展

警告

不在 Marketplace 中的 Docker 扩展未经过 Docker 的审核流程。扩展可以安装二进制文件、调用命令并访问您机器上的文件。安装这些扩展的风险由您自行承担。

扩展 Marketplace 是从 Docker Desktop 内部安装扩展的受信任官方场所。这些扩展已经过 Docker 的审核流程。但是，如果您信任扩展作者，也可以在 Docker Desktop 中安装其他扩展。

鉴于 Docker 扩展的性质（即 Docker 镜像），您可以在其他地方找到用户发布其扩展源代码的位置。例如在 GitHub、GitLab，甚至托管在 DockerHub 或 GHCR 等镜像仓库中。您可以从团队成员那里安装社区开发或您公司内部开发的扩展。您不仅限于从 Marketplace 安装扩展。

注意

确保选项 **仅允许通过 Docker Marketplace 分发的扩展** 已禁用。否则，这将阻止任何未在 Marketplace 中列出的扩展通过 Extension SDK 工具进行安装。您可以在 **设置** 中更改此选项。

要安装不在 Marketplace 中的扩展，您可以使用 Docker Desktop 捆绑的 Extensions CLI。

在终端中，输入 `docker extension install IMAGE[:TAG]` 以通过镜像引用和可选标签安装扩展。使用 `-f` 或 `--force` 标志以避免交互式确认。

转到 Docker Desktop 仪表板以查看新安装的扩展。

列出已安装的扩展

无论扩展是从 Marketplace 安装还是通过 Extensions CLI 手动安装，您都可以使用 `docker extension ls` 命令显示已安装扩展的列表。作为输出的一部分，您将看到扩展 ID、提供者、版本、标题以及它是否运行后端容器或是否已将二进制文件部署到主机，例如

$ docker extension ls
ID                  PROVIDER            VERSION             UI                    VM                  HOST
john/my-extension   John                latest              1 tab(My-Extension)   Running(1)          -

转到 Docker Desktop 仪表板，选择 **添加扩展**，然后在 **已管理** 选项卡上查看新安装的扩展。请注意，会显示一个 `UNPUBLISHED` 标签，表示该扩展不是从 Marketplace 安装的。

更新扩展

要更新不在 Marketplace 中的扩展，请在终端中输入 `docker extension update IMAGE[:TAG]`，其中 `TAG` 应与已安装的扩展不同。

例如，如果您使用 `docker extension install john/my-extension:0.0.1` 安装了扩展，则可以通过运行 `docker extension update john/my-extension:0.0.2` 来更新它。转到 Docker Desktop 仪表板以查看新更新的扩展。

注意

未通过 Marketplace 安装的扩展不会收到 Docker Desktop 的更新通知。

卸载扩展

要卸载不在 Marketplace 中的扩展，您可以导航到 Marketplace 中的 **已管理** 选项卡并选择 **卸载** 按钮，或者从终端输入 `docker extension uninstall IMAGE[:TAG]`。