CentOS 上安装 Docker 的详细指南

一、前置条件

在开始安装 Docker 之前，确保以下几点：

操作系统版本：本文以 CentOS 7 和 CentOS 8 为例。如果你使用的是其他版本，请参考官方文档。权限要求：需要使用 root 用户或具有 sudo 权限的用户。

二、卸载旧版本

首先检查并卸载系统中可能存在的旧版本 Docker，旧版本的 Docker 称为 <code>docker 或 docker-engine：

sudo yum remove docker \

docker-client \

docker-client-latest \

docker-common \

docker-latest \

docker-latest-logrotate \

docker-logrotate \

docker-engine

三、设置 Docker 仓库

为了能够安装 Docker，首先需要设置 Docker 的官方仓库。

安装必备软件包：这些软件包允许 yum 使用 HTTPS 进行传输。

sudo yum install -y yum-utils \

device-mapper-persistent-data \

lvm2

添加 Docker 仓库：

sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

四、安装 Docker

使用 yum 安装 Docker CE（社区版）：

sudo yum install docker-ce docker-ce-cli containerd.io

系统会自动下载并安装所有的依赖包。

常见错误及解决方法：

错误 1：GPG Key 验证失败

描述：在安装过程中，可能会遇到 GPG Key 验证失败的情况。解决方案：

sudo yum install -y --nogpgcheck docker-ce

错误 2：依赖冲突

描述：有时可能会遇到依赖包之间的冲突。解决方案：

使用 --skip-broken 参数：

sudo yum install docker-ce --skip-broken

如果仍然失败，可以手动解决冲突或更新相关软件包。

五、启动 Docker

安装完成后，需要启动 Docker 并设置开机自启：

sudo systemctl start docker

sudo systemctl enable docker

可以使用以下命令检查 Docker 是否正确启动：

sudo systemctl status docker

六、运行 Hello World 容器

为了验证 Docker 安装是否成功，可以运行一个简单的 hello-world 容器：

sudo docker run hello-world

如果一切正常，系统将输出类似以下的消息：

Hello from Docker!

This message shows that your installation appears to be working correctly.

常见错误及解决方法：

错误 1：Cannot connect to the Docker daemon

描述：可能是 Docker 服务未启动或用户没有权限。解决方案：

确保 Docker 服务已启动：

sudo systemctl start docker

使用 sudo 运行 Docker 命令或将用户添加到 docker 组：

sudo usermod -aG docker $USER

错误 2：Could not resolve host: mirrorlist.centos.org

描述：无法解析CentOS镜像域名。

解决方案：

这个错误表明系统无法解析 mirrorlist.centos.org 的域名，可能是网络连接问题或 DNS 配置问题。以下是几种不同情况的解决方法：

检查网络连接

确保服务器的网络连接正常：

ping -c 4 1.0.0.1

如果没有回应，检查网络配置和连接。

更改 DNS 配置

编辑 /etc/resolv.conf 文件，添加或更换 DNS 服务器：

sudo vi /etc/resolv.conf

添加以下内容：

nameserver 223.5.5.5

nameserver 1.0.0.1

保存并退出文件后，再试一次。

手动配置 CentOS 仓库

如果无法使用默认的镜像列表，可以直接指定可用的仓库 URL。

备份并编辑仓库配置文件

sudo cp /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak

sudo vi /etc/yum.repos.d/CentOS-Base.repo

注释掉 mirrorlist 行，并添加 baseurl。以下示例使用阿里云镜像，您可以根据需要替换为其他镜像站点：

# CentOS-Base.repo

#

# The mirror system uses the connecting IP address of the client and the

# update status of each mirror to pick mirrors that are updated to and

# geographically close to the client. You should use this for CentOS updates

# unless you are manually picking other mirrors.

#

# If the mirrorlist= does not work for you, as a fall back you can try the

# remarked out baseurl= line instead.

#

#

[base]

name=CentOS-$releasever - Base

#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&infra=$infra

#baseurl=http://mirror.centos.org/centos/$releasever/os/$basearch/

baseurl=http://mirrors.aliyun.com/centos/$releasever/os/$basearch/

gpgcheck=1

gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#released updates

[updates]

name=CentOS-$releasever - Updates

#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates&infra=$infra

#baseurl=http://mirror.centos.org/centos/$releasever/updates/$basearch/

baseurl=http://mirrors.aliyun.com/centos/$releasever/updates/$basearch/

gpgcheck=1

gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#additional packages that may be useful

[extras]

name=CentOS-$releasever - Extras

#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras&infra=$infra

#baseurl=http://mirror.centos.org/centos/$releasever/extras/$basearch/

baseurl=http://mirrors.aliyun.com/centos/$releasever/extras/$basearch/

gpgcheck=1

gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#additional packages that extend functionality of existing packages

[centosplus]

name=CentOS-$releasever - Plus

#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=centosplus&infra=$infra

#baseurl=http://mirror.centos.org/centos/$releasever/centosplus/$basearch/

baseurl=http://mirrors.aliyun.com/centos/$releasever/centosplus/$basearch/

gpgcheck=1

enabled=0

gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

保存并退出文件。

更新 yum 缓存

清除 yum 缓存并更新：

sudo yum clean all

sudo rm -rf /var/cache/yum

sudo yum makecache

测试仓库连接

尝试安装 yum-utils 以确认问题是否解决：

sudo yum install -y yum-utils

七、配置 Docker 镜像加速

在中国大陆，直接访问 Docker 官方镜像库的速度较慢。可以使用国内的镜像加速服务。

修改 Docker 配置文件：

sudo mkdir -p /etc/docker

编辑 /etc/docker/daemon.json 文件，并添加如下内容：

{

"registry-mirrors": ["https://<your-mirror-url>"]

}

以下是一些常用的 Docker registry mirrors：

DaoCloud 镜像加速器: https://docker.m.daocloud.ioDockerProxy: https://dockerproxy.comUSTC (中国科学技术大学) 镜像: https://docker.mirrors.ustc.edu.cn南京大学镜像: https://docker.nju.edu.cn阿里云加速器: https://registry.cn-hangzhou.aliyuncs.com腾讯云加速器: https://mirror.ccs.tencentyun.com华为云加速器: https://repo.huaweicloud.com七牛云加速器: https://reg-mirror.qiniu.com网易云加速器: https://hub-mirror.c.163.com中科大镜像: https://docker.mirrors.ustc.edu.cn

你可以在 Docker 的配置文件 /etc/docker/daemon.json 中添加这些镜像地址：

{

"registry-mirrors": [

"https://docker.m.daocloud.io",

"https://dockerproxy.com",

"https://docker.mirrors.ustc.edu.cn",

"https://docker.nju.edu.cn",

"https://registry.cn-hangzhou.aliyuncs.com",

"https://mirror.ccs.tencentyun.com",

"https://repo.huaweicloud.com",

"https://reg-mirror.qiniu.com",

"https://hub-mirror.c.163.com",

"https://docker.mirrors.ustc.edu.cn"

]

}

配置完成后，重启 Docker 服务即可生效。

重新启动 Docker 服务：

sudo systemctl daemon-reload

sudo systemctl restart docker

进一步阅读

Docker 官方文档CentOS 官方文档