优先升级客户端至20.10+（对应api v1.40+），并确认守护进程版本不低于该要求；运行docker version查看client与server的api版本差异，据此判断是客户端过旧或过新，并同步检查守护进程、docker-compose、maven插件及spring boot配置兼容性。

核心是让客户端与守护进程（服务端）的 api 版本对齐，优先升级客户端至 20.10+（对应 api v1.40+），同时确认守护进程版本不低于该要求。

快速确认当前版本差异

运行 docker version 查看 Client 和 Server 的 API version：

• 若 Client 显示 1.24、1.37 等旧值，Server 显示 1.40 或更高 → 客户端太旧
• 若 Client 显示 1.53，Server 显示 1.41 → 客户端太新（常见于 docker-compose 单独升级）
• 错误提示如 "client version 1.24 is too old. Minimum supported API version is 1.40" 或 "client version 1.53 is too new. Maximum supported API version is 1.41" 都指向 API 版本越界

升级 Docker 客户端（最常用解法）

客户端 CLI 工具独立于守护进程，升级它即可解决多数不兼容问题：

• Windows/macOS：下载安装最新版 Docker Desktop（自动包含匹配的 docker CLI）
• Ubuntu/Debian：sudo apt-get update && sudo apt-get install docker-ce-cli
• CentOS/RHEL：sudo yum install docker-ce-cli（需已配置 Docker 官方源）

安装后再次运行 docker version，确保 Client API version ≥ 1.40（通常 Docker 20.10+ 自带）。

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

检查并协调守护进程与配套工具

仅升级客户端不够，还需同步验证其他环节：

• 守护进程（dockerd）建议也升级到 20.10+，避免反向不兼容；可用 sudo systemctl restart docker 启动新版本
• 若用 docker-compose，单独检查其版本：docker-compose --version；新版推荐改用 docker compose（v2 内置子命令），或升级 docker-compose 至 ≥ 2.20.0
• Maven 项目中若使用 docker-maven-plugin，需升级至 ≥ 1.4.13；Spring Boot 应用可显式指定 docker.api-version=1.40（application.properties）

临时绕过方案（仅限调试）

无法立即升级时，可通过环境变量强制指定通信 API 版本：

• Linux/macOS：export DOCKER_API_VERSION=1.40
• Windows PowerShell：$env:DOCKER_API_VERSION="1.40"
• 命令行中直接加参数：docker --api-version 1.40 info

注意：这只是跳过版本校验，不解决功能缺失或安全风险，不可用于生产环境。