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

适用于 RHEL 8 / 9 的 Docker 一键安装脚本:检查订阅状态、清理与 containerd 冲突的 podman/runc、配置阿里云 Docker CE 源,安装 docker-ce、buildx 与 compose 插件,附 SELinux 挂载、firewalld 与卸载说明。

RHEL 8 / 9 · Docker 27.x更新于 2026-10-30共 24 条

前置检查与清理

确认 RHEL 版本并查看可用仓库,订阅未注册时默认源不可用

cat /etc/redhat-release
dnf repolist

检查订阅状态,未注册时先注册并自动附加可用订阅

sudo subscription-manager status
sudo subscription-manager register --auto-attach

RHEL 自带 podman 与 runc,runc 与 containerd.io 冲突,安装前先移除

sudo dnf remove -y podman buildah runc

提供 dnf config-manager,用于添加第三方软件源

sudo dnf install -y dnf-plugins-core

一键安装脚本

保存为 install-docker-rhel.sh 后以 root 执行即可完成安装

#!/bin/bash
set -euo pipefail

echo "当前系统: $(cat /etc/redhat-release)"

# 订阅检查,未注册时给出提示而不中断
if command -v subscription-manager >/dev/null 2>&1; then
  subscription-manager status >/dev/null 2>&1 || echo "警告: 订阅未注册,请先执行 subscription-manager register"
fi

# 移除与 containerd.io 冲突的包
sudo dnf remove -y podman buildah runc || true
sudo dnf install -y dnf-plugins-core

# 添加阿里云 Docker CE 仓库
sudo dnf config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/rhel/docker-ce.repo

# 安装 Docker 引擎与插件
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 开机自启并验证
sudo systemctl enable --now docker
docker --version
docker compose version

若仓库地址返回 404,可改用 /docker-ce/linux/centos/docker-ce.repo 或官方 download.docker.com 源

赋予执行权限并以 root 运行,避免脚本内反复输入密码

chmod +x install-docker-rhel.sh
sudo bash install-docker-rhel.sh

分步安装命令

添加 Docker CE 仓库并确认 repo 文件已生成

sudo dnf config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/rhel/docker-ce.repo
ls /etc/yum.repos.d/ | grep docker

刷新元数据并查看可安装版本,确认版本来自 Docker 源

sudo dnf makecache
dnf list docker-ce --showduplicates | head

一次装齐引擎、CLI、containerd、buildx 与 compose 插件

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

遇到 runc 或 podman 依赖冲突时,用 --allowerasing 让 dnf 移除冲突包

sudo dnf install -y --allowerasing docker-ce

验证三个组件可用,compose 为插件形式而非旧二进制

docker --version
docker compose version
docker buildx version

安装后配置

开机自启并立即启动,确认状态为 active (running)

sudo systemctl enable --now docker
systemctl status docker --no-pager

加入 docker 组以免 sudo,newgrp 立即生效,否则需重新登录

sudo usermod -aG docker "$USER"
newgrp docker

docker 组等价于 root 权限,多用户主机请谨慎授权

配置镜像加速地址,替换为云厂商控制台提供的专属地址

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

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

RHEL 8/9 默认 cgroup v2 与 overlay2,cgroup v1 异常时排查内核启动参数

docker info | grep -iE "cgroup|storage driver"

卸载与清理

卸载 Docker 组件,保留 /var/lib/docker 中的镜像与卷

sudo dnf 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 dnf makecache

本网站使用 Cookie 以确保您在我们的网站上获得最佳体验。 隐私政策.