这份教程专门针对 CentOS 服务器 环境编写，实际我在操作过程中遇到了各种问题，这里整理好一份完整的安装方法，避过可能遇到的坑点，可以先收藏，以防之后需要找不到了。

CentOS 快速部署 Docker 指南

本教程将指导你完成 Docker 及 Docker Compose 的安装，并配置好云加速器，为你后续部署服务器部署 Docker 应用打好基础。

一、 环境清理（防止冲突）

如果你的服务器之前尝试安装过旧版本或错误的包，先执行以下命令清理环境：

sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

二、 配置 Docker 软件源

由于官方 Docker 源在国内访问不稳定，我们直接切换到阿里云提供的镜像源。

# 1. 安装基础工具包
sudo yum install-y yum-utils

# 2. 添加阿里云 Docker 镜像源（核心步骤）
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 3. 更新索引并安装 Docker
sudo yum makecache fast
sudo yum install-y docker-ce docker-ce-cli containerd.io

三、 启动与开机自启

安装完成后，需要手动启动服务并设置为每次开机自动运行。

sudo systemctl start docker
sudo systemctl enabledocker

四、 配置镜像加速器（避坑重点）

这一步非常关键！ 如果不配置，后续下载应用镜像会极慢甚至超时。

vim /etc/docker/daemon.json

添加如下内容

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://huecker.io",
    "https://dockerhub.timeweb.cloud",
    "https://noohub.net"
  ]
}

让配置生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

五、 安装 Docker Compose (V2 版本)

不再建议手动去 GitHub 下载二进制文件（容易出错），推荐直接使用官方插件式安装，更稳健。

# 安装 Docker Compose 插件
sudo yum install-y docker-compose-plugin

# 验证安装是否成功
docker compose version

注意： 使用此方法安装后，命令为 docker compose（中间是空格），不再是带连字符的 docker-compose。

六、 总结：如何验证安装成功？

输入以下命令，如果能看到版本号和运行状态，说明你已经成功通关：

1. docker version
    (查看 Docker 版本)
2. systemctl status docker
    (看到绿色的 active (running))
3. docker compose version
    (查看 Compose 版本)

下一步建议

环境准备好后，你就可以在 docker应用目录下创建 docker-compose.yml 文件，执行 docker compose up -d 来启动系统了。

错误历史

root@il0hZ ~# yum-config-manager --add-repo

Loaded plugins: fastestmirror

adding repo from: https://download.docker.com/linux/centos/docker-ce.repo

grabbing file https://download.docker.com/linux/centos/docker-ce.repo to /etc/yum.repos.d/docker-ce.repo

Could not fetch/save url https://download.docker.com/linux/centos/docker-ce.repo to file /etc/yum.repos.d/docker-ce.repo: [Errno 14] curl#35 - "TCP connection reset by peer"

服务器在尝试连接 Docker 官方服务器时被“墙”挡住了。因为你用的国内云服务器，改为国内镜像源，速度快且稳。
官方的 download.docker.com 连不上，换成阿里云的镜像源地址：

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