在 Ubuntu 上安装 Docker Desktop

Docker Desktop 条款

在大型企业(员工人数超过 250 人或年营收超过 1000 万美元)中将 Docker Desktop 用于商业用途,需要 付费订阅

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

前提条件

要成功安装 Docker Desktop,您必须:

  • 满足 通用系统要求
  • 拥有配备 Ubuntu 22.04、24.04 或最新非 LTS 版本的 x86-64 系统。
  • 对于非 Gnome 桌面环境,必须安装 gnome-terminal
    $ 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
    

    注意

    在安装过程结束时,由于安装下载的软件包,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 可执行文件上设置权限,以映射特权端口并设置资源限制。
  • 为 Kubernetes 添加 DNS 名称到 /etc/hosts
  • /usr/local/bin/com.docker.cli 创建符号链接至 /usr/bin/docker。 这是由于经典 Docker CLI 安装在 /usr/bin/docker 处。Docker Desktop 安装程序还会安装一个包含云集成功能的 Docker CLI Binaries,该文件本质上是 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 引擎(使用默认上下文)发生冲突。在关闭时,Docker Desktop 会将当前上下文重置为之前的上下文。

Docker Desktop 安装程序会更新主机上的 Docker Compose 和 Docker CLI Binaries。 它安装 Docker Compose V2,并允许用户在设置面板中选择是否将其链接为 docker-compose。 Docker Desktop 还会安装包含云集成功能的新版 Docker CLI Binaries(路径为 /usr/local/bin/com.docker.cli), 并在 /usr/local/bin 处创建指向经典 Docker CLI 的符号链接。

成功安装 Docker Desktop 后,您可以通过运行以下命令来检查这些Binaries的版本:

$ docker compose version
Docker Compose version v2.29.1

$ docker --version
Docker version 27.1.1, build 6312585

$ docker version
Client: 
 Version:           23.0.5
 API version:       1.42
 Go version:        go1.21.12
<...>

要使 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-<arch>.deb

请不要忘记将 <arch> 替换为您所需的架构。

后续步骤