CentOS 安装 Docker 完整教程(阿里云源+镜像加速,避坑版)

对于 CentOS 系统,Docker 安装最容易踩的坑就是「官方源下载慢」「镜像加速失效」「旧版本冲突」。这篇教程整理了 全程实操无踩坑步骤,用阿里云源替代官方源,搭配可用的镜像加速器,新手也能一步到位完成安装,复制命令直接执行即可!

一、卸载旧版 Docker(必做步骤)

如果系统中已安装旧版 Docker 或相关组件,不卸载会导致新版本安装失败,直接执行以下命令批量卸载,无需手动删除单个组件:

yum remove docker \
    docker-client \
    docker-client-latest \
    docker-common \
    docker-latest \
    docker-latest-logrotate \
    docker-logrotate \
    docker-engine \
    docker-selinux

💡 提示:如果系统从未安装过 Docker,执行此命令会提示「无相关包可卸载」,直接跳过即可,不影响后续操作。

二、配置 Docker 的 YUM 仓库(阿里云源,超快速)

Docker 官方源在国内访问速度较慢,这里直接配置阿里云专属 Docker YUM 源,大幅提升下载速度,步骤分两步:

1. 安装必要的 YUM 工具

安装 yum-utils 等工具,用于配置 YUM 源和管理软件包,执行命令:

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

2. 配置阿里云 Docker YUM 源

执行以下命令,将阿里云 Docker 源添加到系统 YUM 配置中,同时替换默认的官方源地址,确保后续安装从阿里云下载:

# 添加阿里云 Docker YUM 源
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 替换源地址,进一步优化下载速度
sudo sed -i 's+download.docker.com+mirrors.aliyun.com/docker-ce+' /etc/yum.repos.d/docker-ce.repo

3. 更新 YUM 缓存

配置完源后,更新 YUM 缓存,让系统识别新添加的 Docker 源,执行命令:

sudo yum makecache fast

三、安装 Docker 最新版

缓存更新完成后,执行以下命令,一键安装 Docker 完整组件(包含 Docker CE、CLI、容器运行时等),无需手动选择版本:

yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

✅ 说明:此命令会安装 Docker 最新稳定版,适合大多数开发者和生产环境使用;如果需要指定版本,可在 docker-ce 后加上版本号(如 docker-ce-24.0.6)。

四、启动 Docker 并校验安装

安装完成后,需要启动 Docker 服务,并设置开机自启,避免重启系统后 Docker 失效,同时校验安装是否成功,命令如下(复制执行即可):

# 启动 Docker 服务
systemctl start docker

# 停止 Docker 服务(如需)
# systemctl stop docker

# 重启 Docker 服务(如需)
# systemctl restart docker

# 设置 Docker 开机自启(关键步骤)
systemctl enable docker

# 校验安装是否成功(无报错即正常)
docker ps

💡 校验说明:执行 docker ps 后,若未报错(即使没有运行的容器,显示空列表也正常),说明 Docker 启动成功;若报错,可检查前面的步骤是否执行到位。

五、配置 Docker 镜像加速(解决拉取镜像慢,避坑重点)

默认情况下,Docker 拉取镜像(如 Nginx、MySQL)会从官方仓库下载,速度较慢。这里整理了 可用的镜像加速器(剔除失效地址),配置后拉取速度可提升 10 倍以上,步骤如下:

1. 创建 Docker 配置目录

首先创建 Docker 配置文件所在目录(若已存在,会自动跳过):

mkdir -p /etc/docker

2. 配置镜像加速器

执行以下命令,将可用的镜像加速器写入配置文件(已剔除失效的 163、USTC、awsl9527 等地址,保留稳定可用的源):

tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
        "https://mirrors.tuna.tsinghua.edu.cn",
        "http://mirrors.sohu.com",
        "https://ccr.ccs.tencentyun.com",
        "https://docker.m.daocloud.io"
    ]
}
EOF

3. 重新加载配置并重启 Docker

配置完成后,需要重新加载 Docker 配置,重启 Docker 服务,让加速配置生效:

# 重新加载 Docker 配置
systemctl daemon-reload

# 重启 Docker 服务
systemctl restart docker

六、补充:阿里云镜像加速(已停用,慎选)

⚠️ 重要提示:阿里云个人镜像加速器已逐步停用,目前大多数用户配置后无法生效,这里仅保留步骤供参考,优先推荐上面的通用镜像加速配置。

若仍想尝试阿里云镜像加速,步骤如下:

1. 注册并登录阿里云账号

访问阿里云官网:https://www.aliyun.com/,注册并登录个人账号。

2. 开通容器镜像服务

在阿里云首页「产品」中,搜索「容器镜像服务」,进入后点击「立即开通」(免费开通),然后进入控制台。

3. 获取个人镜像加速地址并配置

在控制台左侧找到「镜像工具」→「镜像加速器」,向下滚动即可看到个人专属的镜像加速地址(格式:https://xxxx.mirror.aliyuncs.com),替换以下命令中的地址并执行:

# 创建目录(若已创建,可跳过)
mkdir -p /etc/docker

# 复制内容,替换其中的加速地址为自己的阿里云专属地址
tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://xxxx.mirror.aliyuncs.com"]
}
EOF

# 重新加载配置并重启 Docker
systemctl daemon-reload
systemctl restart docker

七、常见问题排查

  • 安装失败:检查是否已卸载旧版 Docker,是否执行了 yum makecache fast 更新缓存;
  • 镜像拉取慢:确认镜像加速配置是否生效,可更换配置中的加速地址;
  • Docker 启动失败:检查防火墙是否放行 Docker 相关端口,或重新执行安装命令。

至此,CentOS 系统 Docker 安装、启动、加速配置全部完成,接下来就可以拉取镜像、运行容器,开启 Docker 学习和使用之旅啦!

更多推荐