CentOS 自动安装 Docker 脚本 - 码剑客

适用于 CentOS 7 / 8 / Stream 9 的 Docker 一键安装脚本:自动识别 yum 或 dnf、切换 EOL 后的 vault 源、锁定 CentOS 7 可用的 docker-ce 版本、配置阿里云源并安装 compose 插件,附 SELinux 与卸载说明。

CentOS 7 / 8 / Stream 9 · Docker 25.x / 27.x更新于 2026-10-30共 24 条

前置检查与源修复

确认版本与包管理器:CentOS 7 只有 yum,8 与 Stream 9 使用 dnf

cat /etc/centos-release
command -v dnf || command -v yum

CentOS 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 version

CentOS 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 | head

CentOS 8 / Stream 9 直接安装最新版本与 compose 插件

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

CentOS 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-pager

CentOS 默认 SELinux 为 Enforcing,挂载目录需加 :z 或 :Z 标签

getenforce
docker run --rm -v /data/html:/usr/share/nginx/html:z nginx:1.25

Docker 端口映射不经过 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 以确保您在我们的网站上获得最佳体验。 隐私政策.