CentOS Stream Docker 安装与配置全流程指南

验证仓库：执行 sudo dnf repolist 确认 docker-ce 仓库已加入。

步骤 4：安装 Docker 引擎

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

关键提示：安装过程中会提示验证 GPG 密钥，确认指纹匹配：060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35

安装组件说明：

• docker-ce：Docker 引擎核心
• docker-ce-cli：Docker 命令行客户端
• containerd.io：容器运行时
• docker-buildx-plugin：构建多平台镜像
• docker-compose-plugin：Docker Compose 集成

步骤 5：启动 Docker 服务并设置开机自启

sudo systemctl start docker
# 启动服务
sudo systemctl enable docker
# 设置开机自启
sudo systemctl status docker
# 检查状态（应显示 "active (running)"）

步骤 6：配置镜像加速器（解决拉取慢问题）

重启 Docker 生效：

sudo systemctl restart docker

编辑 Docker 配置文件：

mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "http://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://ccr.ccs.tencentyun.com",
    "https://docker.rainbond.cc",
    "https://docker.nju.edu.cn"
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}
EOF

重要更新：registry.docker-cn.com 已停止维护，请优先使用 docker.mirrors.ustc.edu.cn 或 hub-mirror.c.163.com。

步骤 7：验证安装

sudo docker run hello-world

成功输出：Hello from Docker! 说明 Docker 服务正常运行。

步骤 8：配置用户权限（避免每次 sudo）

sudo usermod -aG docker $USER
# 将当前用户加入 docker 组
newgrp docker
# 刷新当前 shell 的组权限

验证：执行 docker ps 无需 sudo 即可运行。

三、常见问题解决

❌ 问题 1：连接 Docker 守护进程失败

现象：Cannot connect to the Docker daemon 解决：

1. 确认 Docker 服务已启动：sudo systemctl status docker

重启网络与 Docker：

sudo systemctl restart NetworkManager && sudo systemctl restart docker

❌ 问题 2：防火墙端口冲突（如需暴露 2375 端口）

解决：

sudo firewall-cmd --permanent --add-port=2375/tcp
sudo firewall-cmd --reload

云服务器额外步骤：在云平台（如阿里云、腾讯云）的安全组规则中放行 2375 端口。

❌ 问题 3：GPG 密钥验证失败

解决：

1. 重新执行安装命令。
2. 手动导入密钥：

sudo rpm --import https://mirrors.aliyun.com/docker-ce/linux/centos/gpg

四、关键配置说明

五、后续操作建议

管理容器：

docker ps # 查看运行中容器
docker images # 查看镜像
docker rm $(docker ps -aq) # 清理所有容器

测试网络：

docker run -d --name nginx -p 8080:80 nginx:alpine
curl http://localhost:8080 # 访问测试

重要提示：镜像加速器优先使用 docker.mirrors.ustc.edu.cn（清华大学）或 hub-mirror.c.163.com（网易），避免使用已停用的 registry.docker-cn.com。云服务器需在安全组中放行 Docker 端口（如 2375、80、443 等）。