要在 Ubuntu 上开始使用 Docker Engine,请确保 满足先决条件,然后 安装 Docker。
先决条件
操作系统要求
要安装 Docker Engine,您需要以下 Ubuntu 版本之一的 64 位版本:
- Ubuntu Jammy 22.04 (LTS)
- Ubuntu 小鬼 21.10
- Ubuntu 焦点 20.04 (LTS)
- Ubuntu 仿生 18.04 (LTS)
Docker 引擎与x86_64
(或amd64
)armhf
、、、arm64
和 s390x
架构兼容。
卸载旧版本
旧版本的 Docker 的名称为docker
、docker.io
或 docker-engine
. 在尝试安装新版本之前卸载任何此类旧版本:
$ sudo apt-get remove docker docker-engine docker.io containerd runc
apt-get
如果报告没有安装这些软件包,那也没关系。
/var/lib/docker/
卸载 Docker 时,不会自动删除其中存储的映像、容器、卷和网络。如果您想从全新安装开始,并希望清理任何现有数据,请参阅 卸载 Docker 引擎部分。
安装方法
您可以根据需要以不同的方式安装 Docker Engine:
- Docker Engine 与Docker Desktop for Linux捆绑在一起 。这是最简单、最快捷的开始方式。
- 您还可以从Docker 的
apt
存储库中设置和安装 Docker Engine 。 - 手动安装并手动管理升级。
- 使用方便的脚本。仅推荐用于测试和开发环境。
使用存储库安装
在新主机上首次安装 Docker Engine 之前,您需要设置 Docker 存储库。之后,您可以从存储库安装和更新 Docker。
设置存储库
- 更新
apt
包索引并安装包以允许apt
通过 HTTPS 使用存储库:$ sudo apt-get update $ sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release
- 添加 Docker 的官方 GPG 密钥:
$ sudo mkdir -p /etc/apt/keyrings $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
- 使用以下命令设置存储库:
$ echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
安装 Docker 引擎
- 更新
apt
包索引:$ sudo apt-get update
运行时收到 GPG 错误apt-get update
?您的默认umask可能配置不正确,从而阻止了对存储库公钥文件的检测。在更新包索引之前尝试授予 Docker 公钥文件的读取权限:$ sudo chmod a+r /etc/apt/keyrings/docker.gpg $ sudo apt-get update
- 安装 Docker 引擎、containerd 和 Docker Compose。要安装最新版本,请运行:
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
hello-world
通过运行镜像来验证 Docker Engine 安装是否成功 :$ sudo docker run hello-world
此命令下载测试映像并在容器中运行它。当容器运行时,它会打印一条确认消息并退出。
您现在已经成功安装并启动了 Docker 引擎。用户组存在但不包含任何用户,这docker
就是为什么您需要使用它sudo
来运行 Docker 命令。继续Linux 后安装 以允许非特权用户运行 Docker 命令和其他可选配置步骤。
升级 Docker 引擎
要升级 Docker Engine,请按照 安装说明,选择您要安装的新版本。
从包安装
如果您无法使用 Docker 的apt
存储库来安装 Docker Engine,您可以下载deb
适用于您的发行版的文件并手动安装。每次升级 Docker Engine 时都需要下载一个新文件。
- 去
https://download.docker.com/linux/ubuntu/dists/
。 - 在列表中选择您的 Ubuntu 版本。
- 转到
pool/stable/
并选择适用的架构(amd64
、armhf
、arm64
或s390x
)。 deb
为 Docker 引擎、CLI、containerd 和 Docker Compose 包下载以下文件:containerd.io_<version>_<arch>.deb
docker-ce_<version>_<arch>.deb
docker-ce-cli_<version>_<arch>.deb
docker-compose-plugin_<version>_<arch>.deb
- 安装
.deb
软件包。将以下示例中的路径更新为您下载 Docker 包的位置。$ sudo dpkg -i ./containerd.io_<version>_<arch>.deb \ ./docker-ce_<version>_<arch>.deb \ ./docker-ce-cli_<version>_<arch>.deb \ ./docker-compose-plugin_<version>_<arch>.deb
Docker 守护进程自动启动。 hello-world
通过运行镜像来验证 Docker Engine 安装是否成功 :$ sudo docker run hello-world
此命令下载测试映像并在容器中运行它。当容器运行时,它会打印一条确认消息并退出。
您现在已经成功安装并启动了 Docker 引擎。用户组存在但不包含任何用户,这docker
就是为什么您需要使用它sudo
来运行 Docker 命令。继续Linux 后安装 以允许非特权用户运行 Docker 命令和其他可选配置步骤。
升级 Docker 引擎
要升级 Docker Engine,请下载更新的包文件并重复 安装过程,指向新文件。
使用便捷脚本安装
Docker 在https://get.docker.com/提供了一个方便的脚本, 以非交互方式将 Docker 安装到开发环境中。不建议将便利脚本用于生产环境,但它对于创建适合您的需求的配置脚本很有用。另请参阅 使用存储库安装步骤以了解使用包存储库安装的安装步骤。该脚本的源代码是开源的,可以 docker-install
在 GitHub 上的存储库中找到。
在本地运行脚本之前,请务必检查从 Internet 下载的脚本。在安装之前,请让自己熟悉便捷脚本的潜在风险和限制:
- 该脚本需要
root
或sudo
特权才能运行。 - 该脚本会尝试检测您的 Linux 发行版和版本,并为您配置包管理系统。
- 该脚本不允许您自定义大多数安装参数。
- 该脚本会在不要求确认的情况下安装依赖项和建议。这可能会安装大量软件包,具体取决于主机的当前配置。
- 默认情况下,该脚本安装 Docker、containerd 和 runc 的最新稳定版本。使用此脚本配置机器时,可能会导致 Docker 的主要版本升级意外。在部署到生产系统之前,始终在测试环境中测试升级。
- 该脚本并非旨在升级现有的 Docker 安装。使用脚本更新现有安装时,可能无法将依赖项更新到预期版本,从而导致版本过时。
提示:运行前预览脚本步骤
您可以使用DRY_RUN=1
选项运行脚本,以了解脚本在调用时将运行哪些步骤:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ DRY_RUN=1 sudo sh ./get-docker.sh
此示例从https://get.docker.com/下载脚本 并运行它以在 Linux 上安装最新的稳定版本的 Docker:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh
Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b2737
<...>
您现在已经成功安装并启动了 Docker 引擎。该docker
服务在基于 Debian 的发行版上自动启动。在RPM
基于发行版(例如 CentOS、Fedora、RHEL 或 SLES)上,您需要使用适当的systemctl
orservice
命令手动启动它。如消息所示,默认情况下,非 root 用户无法运行 Docker 命令。
以非特权用户身份使用 Docker,还是以无根模式安装?
安装脚本需要
root
或sudo
具有安装和使用 Docker 的权限。如果要授予非 root 用户对 Docker 的访问权限,请参阅 Linux 的安装后步骤。您也可以在没有root
权限的情况下安装 Docker,或者将其配置为以无根模式运行。有关在无根模式下运行 Docker 的说明,请参阅以 非 root 用户身份运行 Docker 守护程序(无根模式)。
安装预发行版
Docker 还在 https://test.docker.com/上提供了一个方便的脚本,用于在 Linux 上安装 Docker 的预发布版本。此脚本等同于 处的脚本get.docker.com
,但将您的包管理器配置为使用 Docker 包存储库的测试通道。测试通道包括 Docker 的稳定版和预发布版(beta 版、候选发布版)。使用此脚本可以提前访问新版本,并在发布稳定之前在测试环境中对其进行评估。
要从测试通道在 Linux 上安装最新版本的 Docker,请运行:
$ curl -fsSL https://test.docker.com -o test-docker.sh
$ sudo sh test-docker.sh
使用便利脚本后升级 Docker
如果您使用便捷脚本安装 Docker,则应直接使用包管理器升级 Docker。重新运行便捷脚本没有任何好处。如果它尝试重新安装主机上已经存在的存储库,则重新运行它可能会导致问题。
卸载 Docker 引擎
- 卸载 Docker Engine、CLI、containerd 和 Docker Compose 包:
$ sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-compose-plugin
- 主机上的映像、容器、卷或自定义配置文件不会自动删除。要删除所有映像、容器和卷:
$ sudo rm -rf /var/lib/docker $ sudo rm -rf /var/lib/containerd