如何在CentOS上解决Docker冲突

在 CentOS 上解决 Docker 冲突的实用步骤

一、常见冲突类型与快速判断

• 旧版 Docker 与 docker-ce 冲突：安装新版时出现类似“docker-ce conflicts with 2:docker-1.13.1”或“docker-ce-cli conflicts with docker/docker-io”的报错，说明系统中残留了旧包（如 docker、docker-common、docker-engine、docker-io）。
• 容器引擎冲突：系统同时装有 Podman（常见于 CentOS 8 模块流），会与 Docker 的 CLI/服务产生冲突。
• 依赖版本冲突：例如需要更高版本的 container-selinux，而系统现有版本过低导致安装失败。
• 网络/端口冲突：容器端口与宿主机或其他服务端口占用冲突，或自定义网络子网与现有网络重叠。
  以上情形在 CentOS 7/8 的 Docker 安装与升级中均较常见。

二、标准处理流程

1. 清理旧版本与冲突包
   • 查看并移除旧包：
     • CentOS 7：执行 sudo yum remove -y docker docker-common docker-selinux docker-engine
     • 通用清理：sudo yum remove -y docker-ce docker-ce-cli containerd.io（若已部分安装新版）
   • 若提示与 docker / docker-io 冲突，继续卸载对应旧包：sudo yum remove -y docker docker-io
   • 检查并移除 Podman：rpm -q podman 若已安装，执行 sudo yum remove -y podman（必要时连同 buildah 一并移除：sudo yum erase podman buildah）
2. 安装依赖与官方仓库
   • 安装依赖：sudo yum install -y yum-utils device-mapper-persistent-data lvm2
   • 添加 Docker 官方仓库（示例为稳定版）：
     • CentOS 7：sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/7/x86_64/stable
     • CentOS 8：sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/8/x86_64/stable
3. 解决依赖冲突并安装
   • 清理缓存并更新索引：sudo yum clean all && sudo yum makecache fast
   • 若仍报依赖错误，优先升级相关依赖（如 container-selinux）后再安装；在 CentOS 8 可优先使用 dnf 提升依赖解析能力：sudo dnf install -y docker-ce docker-ce-cli containerd.io
   • 如为临时测试环境，可谨慎使用 --skip-broken（不建议生产环境）
4. 启动与验证
   • 启动服务：sudo systemctl start docker
   • 开机自启：sudo systemctl enable docker
   • 验证：docker version、docker info 输出正常即完成安装。

三、典型场景与命令示例

• 场景 A：旧版 Docker 与新版 docker-ce 冲突
  报错示例：
  • “docker-ce conflicts with 2:docker-1.13.1-208.git7d71120.el7_9.x86_64”
  • “docker-ce-cli conflicts with 2:docker-1.13.1-208.git7d71120.el7_9.x86_64”
    处理：
  • sudo yum remove -y docker docker-io docker-engine docker-common
  • 必要时仅移除冲突包：sudo yum remove -y docker-ce docker-ce-cli
  • 再执行安装：sudo yum install -y docker-ce docker-ce-cli containerd.io
• 场景 B：Podman 冲突
  处理：
  • rpm -q podman 确认存在后，sudo yum remove -y podman（如需连同构建工具：sudo yum erase podman buildah）
  • 重新安装 Docker 并启动服务。

四、网络与端口冲突排查

• 端口占用：使用 ss -tulpen | grep <端口> 或 netstat -tulpen | grep <端口> 查找占用进程，停止或调整服务端口后重启容器。
• 自定义网络与 IP 冲突：
  • 查看网络与容器：docker network ls、docker inspect <network_name>
  • 停止相关容器释放 IP：docker stop <container_name>；必要时重建网络或调整子网避免重叠。
• Kubernetes VXLAN 场景：确认 8472/UDP 未被占用或按需修改配置后重启相关服务。
• SELinux 干扰：可临时 sudo setenforce 0 验证是否为 SELinux 导致，再按需在 /etc/selinux/config 中调整策略并重启。

五、注意事项与回退方案

• 数据安全：清理环境前备份重要数据与配置文件；必要时先备份 /var/lib/docker（重装或清理将影响镜像、容器与卷）。
• 谨慎使用 --skip-broken：仅作临时绕过，可能导致功能缺失或运行时异常。
• 版本选择：在 CentOS 8 遇到依赖解析困难时优先使用 dnf；必要时使用 --nobest 放宽选择策略完成安装。
• 回退思路：若新版本异常，可卸载新版后重装指定旧版本（列出可用版本：yum list docker-ce --showduplicates | sort -r，再按需安装）。