确认版本与包管理器:CentOS 7 只有 yum,8 与 Stream 9 使用 dnf
cat /etc/centos-release
command -v dnf || command -v yum适用于 CentOS 7 / 8 / Stream 9 的 Docker 一键安装脚本:自动识别 yum 或 dnf、切换 EOL 后的 vault 源、锁定 CentOS 7 可用的 docker-ce 版本、配置阿里云源并安装 compose 插件,附 SELinux 与卸载说明。
确认版本与包管理器:CentOS 7 只有 yum,8 与 Stream 9 使用 dnf
cat /etc/centos-release
command -v dnf || command -v yumCentOS 7 已 EOL,官方 mirrorlist 失效,切到 vault 归档源后才能安装软件
sudo sed -i 's/mirrorlist/#mirrorlist/g; s|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*.repo
sudo yum clean all && sudo yum makecache修改前先备份 /etc/yum.repos.d,写错会导致 yum 完全不可用
CentOS 8 已 EOL,需把源指向 vault 中的固定版本目录
sudo sed -i 's|mirrorlist.centos.org|vault.centos.org|g; s|\$releasever|8.5.2111|g' /etc/yum.repos.d/CentOS-*.repo
sudo dnf clean all && sudo dnf makecache卸载旧版 Docker 并安装 yum-utils,后者提供 config-manager 命令
sudo yum remove -y docker docker-client docker-common docker-engine
sudo yum install -y yum-utils保存为 install-docker-centos.sh 后以 root 执行,脚本自动区分 yum 与 dnf
#!/bin/bash
set -euo pipefail
echo "当前系统: $(cat /etc/centos-release 2>/dev/null || cat /etc/redhat-release)"
# CentOS 8/Stream 用 dnf,CentOS 7 只有 yum
if command -v dnf >/dev/null 2>&1; then PM=dnf; else PM=yum; fi
echo "包管理器: ${PM}"
VER=$(grep -oE '[0-9]+' /etc/centos-release | head -1)
# 仓库管理工具
sudo ${PM} install -y yum-utils
# 添加阿里云 Docker CE 仓库
sudo ${PM} config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
# CentOS 7 最高支持 docker-ce 25.x,需锁定版本
if [ "${VER}" = "7" ]; then
sudo ${PM} install -y --nobest docker-ce-25.0.5 docker-ce-cli-25.0.5 containerd.io docker-buildx-plugin docker-compose-plugin
else
sudo ${PM} install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
fi
# 开机自启并验证
sudo systemctl enable --now docker
docker --version
docker compose versionCentOS 7 安装前必须先完成 vault 源切换,否则 yum 依赖解析会失败
赋予执行权限并以 root 运行,避免脚本内反复输入密码
chmod +x install-docker-centos.sh
sudo bash install-docker-centos.sh添加 Docker CE 仓库并确认 repo 文件已生成
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
ls /etc/yum.repos.d/ | grep docker刷新缓存并查看可用版本,CentOS 7 上确认最高只到 25.x
sudo yum makecache fast
yum list docker-ce --showduplicates | headCentOS 8 / Stream 9 直接安装最新版本与 compose 插件
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginCentOS 7 锁定最后一个受支持版本,--nobest 避免被依赖求解拒绝
sudo yum install -y --nobest docker-ce-25.0.5 docker-ce-cli-25.0.5 containerd.io验证引擎与 compose 插件,CentOS 7 应输出 25.x
docker --version
docker compose version开机自启并立即启动,确认状态为 active (running)
sudo systemctl enable --now docker
systemctl status docker --no-pager加入 docker 组以免 sudo,newgrp 立即生效,否则需重新登录
sudo usermod -aG docker "$USER"
newgrp docker配置镜像加速地址,替换为云厂商控制台提供的专属地址
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": ["<你的镜像加速地址>"]
}
EOF重载并重启,输出中出现加速地址说明配置已生效
sudo systemctl daemon-reload
sudo systemctl restart docker
docker info | grep -A2 "Registry Mirrors"镜像加速与日志限制需写在同一个 JSON,分开写入会互相覆盖
sudo tee /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": ["<你的镜像加速地址>"],
"log-driver": "json-file",
"log-opts": { "max-size": "100m", "max-file": "3" }
}
EOF运行官方测试镜像,确认引擎与镜像拉取链路正常
docker run --rm hello-world启动失败时先看这两处日志,daemon.json 格式错误最常见
systemctl status docker --no-pager
journalctl -u docker -n 50 --no-pagerCentOS 默认 SELinux 为 Enforcing,挂载目录需加 :z 或 :Z 标签
getenforce
docker run --rm -v /data/html:/usr/share/nginx/html:z nginx:1.25Docker 端口映射不经过 firewalld,对外服务时仍需单独放行
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --reload安装失败时查看 yum 操作日志,确认是否有依赖被跳过或降级
sudo tail -n 50 /var/log/yum.log卸载 Docker 组件,保留 /var/lib/docker 中的镜像与卷
sudo yum remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin删除全部镜像、容器与卷数据,执行后无法恢复
sudo rm -rf /var/lib/docker /var/lib/containerd移除 Docker 源并清理缓存,避免后续安装其他软件时读到失效源
sudo rm -f /etc/yum.repos.d/docker-ce.repo
sudo yum clean all本网站使用 Cookie 以确保您在我们的网站上获得最佳体验。 隐私政策.