在 Ubuntu 上安装 Docker Desktop

Table of contents

Docker Desktop 条款

在大型企业（超过 250 名员工或年收入超过 1000 万美元）中商业使用 Docker Desktop 需要付费订阅。

本页包含有关如何在 Ubuntu 发行版上安装、启动和升级 Docker Desktop 的信息。

先决条件

要成功安装 Docker Desktop，您必须：

  • 满足通用系统要求。
  • 拥有搭载 Ubuntu 22.04、24.04 或最新非 LTS 版本的 x86-64 系统。
  • 如果您不使用 GNOME，则必须安装 gnome-terminal 以启用从 Docker Desktop 访问终端： 
    $ sudo apt install gnome-terminal

安装 Docker Desktop

在 Ubuntu 上安装 Docker Desktop 的推荐方法：

  1. 设置 Docker 的软件包仓库。 参见 使用 apt 仓库安装中的第一步。

  2. 下载最新的 DEB 软件包。有关校验和，请参阅 发行说明。

  3. 使用 apt 安装软件包：

    $ sudo apt-get update
$ sudo apt-get install ./docker-desktop-amd64.deb
    Note

    在安装过程结束时，apt 会因安装下载的软件包而显示错误。您可以忽略此错误消息。

    N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

    默认情况下，Docker Desktop 安装在 /opt/docker-desktop。

DEB 软件包包含一个安装后脚本，可自动完成其他设置步骤。

安装后脚本：

  • 在 Docker Desktop 二进制文件上设置能力（capability），以映射特权端口和设置资源限制。
  • 为 Kubernetes 添加 DNS 名称到 /etc/hosts。
  • 从 /usr/local/bin/com.docker.cli 创建一个指向 /usr/bin/docker 的符号链接。 这是因为经典的 Docker CLI 安装在 /usr/bin/docker。Docker Desktop 安装程序还会安装一个包含云集成功能的 Docker CLI 二进制文件，它本质上是 Compose CLI 的包装器，位于 /usr/local/bin/com.docker.cli。该符号链接确保包装器可以访问经典的 Docker CLI。

启动 Docker Desktop

要启动 Docker Desktop for Linux：

  1. 在您的 Gnome/KDE 桌面中找到 Docker Desktop 应用程序。

  2. 选择 Docker Desktop 以启动 Docker。

    此时将显示 Docker 订阅服务协议。

  3. 选择 接受 继续。接受条款后，Docker Desktop 将会启动。

    请注意，如果您不同意该条款，Docker Desktop 将无法运行。您可以通过稍后打开 Docker Desktop 来选择接受条款。

    更多信息，请参阅 Docker Desktop 订阅服务协议。建议您同时阅读 常见问题解答。

或者，打开终端并运行：

$ systemctl --user start docker-desktop

当 Docker Desktop 启动时，它会创建一个专用的 上下文，供 Docker CLI 作为目标使用，并将其设置为当前正在使用的上下文。这样做是为了避免与可能在 Linux 主机上运行并使用默认上下文的本地 Docker Engine 发生冲突。关闭时，Docker Desktop 会将当前上下文重置为之前的上下文。

Docker Desktop 安装程序会更新主机上的 Docker Compose 和 Docker CLI 二进制文件。它会安装 Docker Compose V2，并允许用户通过设置面板选择将其链接为 docker-compose。Docker Desktop 会在 /usr/local/bin/com.docker.cli 安装包含云集成功能的新版 Docker CLI 二进制文件，并在 /usr/local/bin 创建指向经典 Docker CLI 的符号链接。

成功安装 Docker Desktop 后，您可以通过运行以下命令来检查这些二进制文件的版本：

$ docker compose version
Docker Compose version v2.39.4

$ docker --version
Docker version 28.4.0, build d8eb465

$ docker version
Client:
 Version:           28.4.0
 API version:       1.51
 Go version:        go1.24.7
<...>

要让 Docker Desktop 在登录时自动启动，请从 Docker 菜单中选择 设置 > 常规 > 登录计算机时启动 Docker Desktop。

或者，打开终端并运行：

$ systemctl --user enable docker-desktop

要停止 Docker Desktop，请选择 Docker 菜单图标以打开 Docker 菜单，然后选择 退出 Docker Desktop。

或者，打开终端并运行：

$ systemctl --user stop docker-desktop

升级 Docker Desktop

当 Docker Desktop 发布新版本时，Docker UI 会显示通知。 每次要升级 Docker Desktop 时，您都需要下载新软件包并运行：

$ sudo apt-get install ./docker-desktop-amd64.deb

后续步骤