客户端与守护进程API版本不匹配，本质是docker CLI与daemon协议不兼容；需通过which docker、PATH顺序检查及彻底卸载多版本（如docker.io与docker-ce）来统一来源，确保Client与Server API版本一致或Server≥Client。
客户端与守护进程版本不匹配，本质是 docker cli（如 docker 命令）和 docker daemon（后台服务）之间 api 协议不兼容。错误提示常为：
"client version 1.22 is too old. Minimum supported API version is 1.24" 或 "API version mismatch" —— 即使 docker --version 显示的是 26.x，实际调用的却可能是旧版二进制。
确认真实调用的客户端路径和版本
别只信 docker --version，要验证当前 shell 实际执行的是哪个 docker：
- 运行
which docker查看命令来源路径（如/usr/bin/docker或/usr/local/bin/docker） - 再执行该路径下的版本检查：
/usr/bin/docker --version和/usr/local/bin/docker --version分别比对 - 检查
PATH顺序：echo $PATH，确认高版本路径是否排在低版本之前
清理多版本残留，统一安装源
常见冲突根源是混装：系统包管理器（如 apt install docker.io）与 Docker 官方包（docker-ce）共存：
- 卸载所有旧痕迹：
sudo apt-get purge docker docker-engine docker.io containerd runc（Ubuntu/Debian）或sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux docker-engine-selinux docker-engine（CentOS/RHEL） - 只通过官方源安装
docker-ce和docker-ce-cli，确保 CLI 与 daemon 同源同版本 - 安装后验证：
docker version输出中 Client 和 Server 的 API version 应一致或 Server ≥ Client（向后兼容）
修复 PATH 或硬链接指向正确版本
若新版已存在但未被优先调用：
- 临时修正：
export PATH="/usr/bin:$PATH"（假设新版在/usr/bin） - 永久生效：将上述 export 加入
~/.bashrc或/etc/profile.d/docker.sh - 或重建符号链接：
sudo ln -sf /usr/bin/docker /usr/local/bin/docker（根据实际路径调整）
注意 Docker Compose 是独立项目
docker-compose 不属于 Docker CLI，它有自己的版本演进和 API 依赖：
- 运行
docker-compose --version和docker version --format '{{.Server.APIVersion}}'对照 - v2.20+ 的 Compose 要求 Docker Engine ≥ 24.0；若 Engine 是 23.0.6，则需降级 Compose 或升级 Engine
- 推荐使用
docker compose（内置插件形式，与 CLI 绑定），避免docker-compose（独立二进制）带来的额外版本错位
