在 ubuntu 上如何安装 docker

Docker系列文章链接：

本文记录如何在 ubuntu 系统上安装 docker

系统要求

在 ubuntu 上安装 Docker，要求你的系统必须是 64bit

Ubuntu Mantic 23.10
Ubuntu Lunar 23.04
Ubuntu Jammy 22.04 (LTS)
Ubuntu Focal 20.04 (LTS)

我们最好使用官方推荐的系统版本，避免一些未知问题。在 ubuntu 系统，可以兼容 x86、arm、ppc 等 CPU 架构。

卸载旧包

发行版本中可能提供了非官方版本的 Docker 包，在安装之前需要先把这些包卸载掉。

如下的包需要卸载：

docker.io
docker-compose
docker-compose-v2
docker-doc
podman-docker

Docker Engine 依赖 containerd 和 runc，Docker Engine 将这些依赖合并到一个包：containerd.io。如果之前安装过 containerd 或 runc，请卸载掉，避免与 Docker Engine 版本冲突。

执行如下命令卸载冲突的包：

1
2
3

for pkg in docker.io docker-doc docker-compose docker-ce containerd.io \
    docker-ce-cli docker-compose-v2 podman-docker containerd runc; \
    do sudo apt-get remove $pkg; done

/var/lib/docker 目录的内容主要包括：镜像、容器、卷、网络等，上述命令不会自动删除这些内容。如果你希望全新的安装，可以执行

1	/bin/rm -rf /var/lib/docker/*

安装 Docker（使用apt）

如果是首次安装，需要在服务器上设置 Docker 官方的仓库

（一）设置 Docker apt 仓库

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
    sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) \
  signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

（二）安装 Docker 包

安装仓库中最新的版本

1 2	sudo apt-get install docker-ce docker-ce-cli containerd.io \ docker-buildx-plugin docker-compose-plugin

如果你希望安装指定版本的 Docker，可以通过如下方式：

# List the available versions:
apt-cache madison docker-ce | awk '{ print $3 }'

5:24.0.0-1~ubuntu.22.04~jammy
5:23.0.6-1~ubuntu.22.04~jammy
...

选择要安装的版本

1 2	VERSION_STRING=5:24.0.0-1~ubuntu.22.04~jammy sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

（三）验证 Docker 安装是否成功

运行如下命令

1	sudo docker run hello-world

安装 Docker（通过离线的 deb 包）

有时候当前环境不允许通过 apt 方式安装，还可以通过离线的 deb 包来安装

1. 官方下载地址

https://download.docker.com/linux/ubuntu/dists/

2. 列表中选择 ubuntu 版本

3. 进入 pool/stable，选择正确的架构，比如 amd64

4. 下载所需要的 deb 包

- containerd.io_<version>_<arch>.deb
- docker-ce_<version>_<arch>.deb
- docker-ce-cli_<version>_<arch>.deb
- docker-buildx-plugin_<version>_<arch>.deb
- docker-compose-plugin_<version>_<arch>.deb

5. 安装 deb 包

sudo dpkg -i ./containerd.io_<version>_<arch>.deb \
  ./docker-ce_<version>_<arch>.deb \
  ./docker-ce-cli_<version>_<arch>.deb \
  ./docker-buildx-plugin_<version>_<arch>.deb \
  ./docker-compose-plugin_<version>_<arch>.deb

安装完毕后，Docker 程序会自动启动。

6. 验证是否正确安装

1 2	sudo service docker start sudo docker run hello-world

一键安装 Docker

docker 官方提供了一键安装的脚本

1	curl -fsSL https://get.docker.com \| bash

卸载 Docker

1. 删除安装包

1
2
3

sudo apt-get purge docker-ce docker-ce-cli \
    containerd.io docker-buildx-plugin \
    docker-compose-plugin docker-ce-rootless-extras

2. 删除对应的数据目录

1 2	sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd

安装 compose

上边步骤中我们安装了 docker-compose-plugin 包，该安装包中包含了 docker-compose 工具，直接将二进制复制到执行目录即可。

/bin/cp /usr/libexec/docker/cli-plugins/docker-compose /usr/bin/

# 测试
docker-compose --version

专题: Docker

本文发表于 2024-02-15，最后修改于 2024-02-17。

本站永久域名「 golinuxblog.com 」，也可搜索「 Linux教程网」找到我。

上一篇 « 常用的流量模拟命令总结下一篇 » 配置 docker 镜像加速器