在 Ubuntu 上安装与配置 Docker 的完整指南

发表于 2025-2-17 14:05:55

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要登录才可以下载或查看，没有账号？立即注册

×

Docker 是一种流行的容器化平台，广泛用于开发、部署和运行应用程序。本文将详细先容如何在 Ubuntu 系统上卸载旧版本 Docker、安装最新版本 Docker 以及进行相关配置。无论您是 Docker 新手还是有经验的用户，这份指南都将帮助您顺利完成安装和配置过程。
前置条件

一台运行 Ubuntu 的计算机（本文以 Ubuntu 20.04 为例）。
具有 sudo 权限的用户。

1. 卸载原有版本

在安装最新版本的 Docker 之前，建议先卸载系统中大概存在的旧版本，以制止辩论。

sudo apt-get remove docker docker-engine docker-ce docker.io

复制代码

如果您需要删除全部的镜像、容器和卷（留意：如果是第一次安装，请忽略此步骤）：

sudo rm -rf /var/lib/docker

复制代码

备注：apt-get remove 会保存软件的配置文件。如果想彻底删除包括配置文件，请执行以下操作：
检察相关软件包是否有残余

dpkg -l | grep docker

复制代码

利用 purge 清除配置文件

sudo apt-get purge docker-ce

复制代码

2. 更新索引包

起首确保您的系统是最新的，以制止潜伏的兼容性题目。

sudo apt update
sudo apt upgrade -y

复制代码

3. 安装利用 HTTPS 传输的软件包

Docker 需要利用 HTTPS 来包管传输的安全性，因此需要安装相关的软件包。

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common

复制代码

4. 添加软件源的 GPG 密钥

为了确保下载的软件包的安全性，需要添加 Docker 官方的 GPG 密钥。您可以选择利用不同的镜像源：
中科大源

curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

复制代码

阿里云源

curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

复制代码

官方源

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

复制代码

留意：选择一个镜像源即可，无需同时添加多个源。
5. 向 sources.list 中添加 Docker 软件源

根据您选择的镜像源，执行相应的命令将 Docker 仓库添加到 APT 源列表中。
中科大源

sudo add-apt-repository "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

复制代码

阿里源

sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

复制代码

官方源

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

复制代码

说明：

$(lsb_release -cs) 会主动获取您的 Ubuntu 版本代号（例如 focal）。
stable 表示利用 Docker 的稳定版本仓库。

6. 再次更新索引包

添加完新的 Docker 仓库后，需要再次更新 APT 包索引。

sudo apt-get update

复制代码

7. 检察 Docker 版本

在安装 Docker 之前，您可以检察可用的 Docker 版本。

apt-cache madison docker-ce

复制代码

这将显示全部可用的 Docker 版本及其详细信息。
8. 安装指定版本

您可以选择安装最新版本的 Docker，大概安装指定的 Docker 版本。
安装最新版本

sudo apt-get install docker-ce

复制代码

安装指定版本

起首，利用之前的 apt-cache madison docker-ce
命令检察可用版本，然后选择一个版本进行安装。例如：

sudo apt-get install docker-ce
=18.06.3~ce~3-0~ubuntu

复制代码

说明：将 18.06.3~ce~3-0~ubuntu 替换为您选择的具体版本号。
9. 启动配景服务

安装完成后，启动 Docker 服务。

sudo service docker start

复制代码

大概利用 systemctl 命令：

sudo systemctl start docker

复制代码

10. 检察 Docker 版本信息

确认 Docker 已乐成安装并运行。

docker version

复制代码

这将显示 Docker 客户端和服务器的版本信息。
11. 镜像加速

为了加速 Docker 镜像的下载速度，尤其是在中国大陆用户，可以配置 Docker 利用国内的镜像加速器。新版的 Docker 利用 /etc/docker/daemon.json 来配置保卫进程。
配置镜像加速

创建或编辑 /etc/docker/daemon.json 文件
1. sudo nano /etc/docker/daemon.json
复制代码
添加以下内容
以 Docker 中国官方加速器为例：
1. {
2. "registry-mirrors": ["https://docker.1panel.live"]
3. }
复制代码
您也可以选择其他加速器，例如阿里云：
1. {
2. "registry-mirrors": ["https://<your-accelerator-url>"]
3. }
复制代码
保存并关闭文件（在 Nano 中，按 Ctrl + O 保存，Ctrl + X 退出）
重启 Docker 服务使配置生效
1. sudo service docker restart
复制代码
大概利用 systemctl 命令：
1. sudo systemctl restart docker
复制代码

12. 添加当前用户到 Docker 组（可选）

默认情况下，运行 Docker 命令需要 sudo 权限。为了简化操作，您可以将当前用户添加到 docker 组中，从而无需每次都利用 sudo。
创建 docker 组

sudo groupadd docker

复制代码

将当前用户参加 docker 组

sudo usermod -aG docker $USER

复制代码

查抄用户是否乐成参加 docker 组

cat /etc/group | grep docker

复制代码

您应该会看到类似如下的输出，显示您的用户名在 docker 组中：

docker:x:999:yourusername

复制代码

重启 Docker 服务

sudo systemctl restart docker

复制代码

重新登录或重启系统

为了使组成员资格生效，您需要重新登录或重启系统。
总结

通过以上步骤，您已经乐成在 Ubuntu 系统上卸载旧版本 Docker、安装最新版本 Docker，并进行了必要的配置，如镜像加速和用户权限设置。现在，您可以开始利用 Docker 进行容器化开发和部署了。
常见题目与办理方案：

Docker 无法启动：查抄 Docker 服务状态，确保服务正在运行。利用 sudo systemctl status docker 检察服务状态。
权限不足：确保您已将当前用户添加到 docker 组，并已重新登录。
镜像下载缓慢：配置 Docker 镜像加速器，以进步下载速度。

如果在安装或配置过程中遇到任何题目，欢迎在评论区留言或参考 Docker 官方文档获取更多帮助。

在 Ubuntu 上安装与配置 Docker 的完整指南

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

浏览过的版块