这份教程专门针对 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。
六、 总结:如何验证安装成功?
输入以下命令,如果能看到版本号和运行状态,说明你已经成功通关:
docker version(查看 Docker 版本) systemctl status docker(看到绿色的 active (running)) 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
夜雨聆风