Ubuntu 安装 Docker Desktop

简介

Docker 有两种版本：Docker Desktop 和 Docker Engine（也称作 Docker CE）。Docker Desktop 是带图形界面的版本，适合在个人 PC 上使用。Docker Engine 则只有命令行接口，适合在没有图形界面的服务器上使用。

这篇文章将介绍在 Ubuntu Desktop 上安装 Docker Desktop 的方法。如果你需要安装 Docker Engine，请参阅 Ubuntu 安装 Docker Engine。

安装

1. 将 Docker 软件源添加到 APT 源列表：

   # 添加 Docker 软件源的 GPG 公钥：
   sudo apt install -y ca-certificates curl     # 安装 curl 及 curl 用到的 CA 证书
   sudo install -m 0755 -d /etc/apt/keyrings    # 确保公钥存储文件夹存在
   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc  # 下载公钥文件
   sudo chmod a+r /etc/apt/keyrings/docker.asc  # 设置公钥文件权限
   
   # 将 Docker 软件源添加到 APT 源列表
   echo \
       "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
       $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
       sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   
   # 更新 APT 索引
   sudo apt update
   

2. 下载并安装 Docker Desktop：

   # 下载
   wget https://desktop.docker.com/linux/main/amd64/docker-desktop-amd64.deb
   # 安装
   sudo apt install ./docker-desktop-amd64.deb
   

   在安装时可能会收到如下警告：

   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)
   

   这是由于使用 apt 安装手动下载的包导致的，你可以忽略这个警告。

此时，你的 Docker Desktop 就安装完成了。你可以在程序菜单中找到 Docker Desktop。

参考：Install Docker Desktop on Ubuntu | Docker Docs

Troubleshooting

在 Ubuntu 虚拟机中无法启动 Docker Desktop

在 Ubuntu 虚拟机中打开 Docker Desktop 时遇到需要开启 KVM 模块的报错。这表明你的虚拟机没有开启 KVM。如果你的虚拟机管理软件是 VMware Workstation Pro，那么你可以通过在虚拟机设置中开启 虚拟化 Intel VT-x/EPT 或 AMD-V/RVI 选项来启用 KVM 支持。

如果你在开启 虚拟化 Intel VT-x/EPT 或 AMD-V/RVI 选项时遇到错误，请参考 VMware Workstation Pro 开启虚拟化引擎
。

接下来在 Ubuntu 虚拟机中手动加载 KVM 模块：

modprobe kvm  # 加载 KVM 内核模块

然后根据你 CPU 的类型，运行下面其中一条命令：

modprobe kvm_intel  # 启用 Intel 处理器的 KVM 模块（VT-x）
modprobe kvm_amd    # 启用 AMD 处理器 的 KVM 模块（AMD-V）

如果上面的命令运行失败，你可以运行这条命令进行诊断：

sudo kvm-ok

你可以通过下面的命令检查 kvm 模块和 kvm_xxx 模块是否安装成功：

$ lsmod | grep kvm
kvm_amd               208896  0
kvm                  1404928  1 kvm_amd
irqbypass              12288  1 kvm
ccp                   143360  1 kvm_amd

参考：KVM virtualization support | Docker Docs

Ubuntu 24.04 打开 Docker Desktop 没反应

根据 Docker 的安装说明，截至 2024.08.25，Docker Desktop 尚不支持 Ubuntu 24.04 LTS。要启动 Docker Desktop，需要在启动前运行：

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0  # 禁用 AppArmor 对非特权用户命名空间的限制

The latest Ubuntu 24.04 LTS is not yet supported. Docker Desktop will fail to start. Due to a change in how the latest Ubuntu release restricts the unprivileged namespaces, sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0 needs to be run at least once. Refer to the Ubuntu Blog for more details.

参考：docker-desktop does not launch on ubuntu [Failed to start docker-desktop.service: Unit docker-desktop.service is masked] [closed] | Stack Overflow