在 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 以启用从 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 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 二进制文件设置功能，以映射特权端口并设置资源限制。
• 为 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 install ./docker-desktop-amd64.deb

后续步骤

• 查看 Docker 的订阅，了解 Docker 可以为您提供什么。
• 按照 Docker 研讨会 学习如何构建镜像并将其作为容器化应用程序运行。
• 探索 Docker Desktop 及其所有功能。
• 故障排除 描述了常见问题、解决方法、如何运行和提交诊断信息以及提交问题。
• 常见问题解答 提供常见问题的答案。
• 发行说明 列出了与 Docker Desktop 版本相关的组件更新、新功能和改进。
• 备份和恢复数据 提供了有关备份和恢复 Docker 相关数据的说明。