首页/云/Docker 容器速查/客户端与服务端 API 版本不匹配
容器排障52 条

客户端与服务端 API 版本不匹配

client version is too new/old for API version:老客户端连新 daemon(或反向);升级客户端为正解,DOCKER_API_VERSION 只做临时兼容。

Docker 容器速查云更新于 2026-10-12
报错client version X too new/old
对比docker version 的 Client/Server APIVersion
临时DOCKER_API_VERSION=1.41 兼容旧脚本

示例

示例
docker version --format 'client={{.Client.APIVersion}} server={{.Server.APIVersion}}'
DOCKER_API_VERSION=1.41 docker ps
锁定 API 版本会同时锁住可用功能,长期要在维护窗口升级客户端版本。

易错点

  • 把 DOCKER_API_VERSION 写进 CI 常驻配置会掩盖升级问题,只作应急
  • SDK/脚本用的 API 版本与 CLI 不同,报错时分别核对工具各自的版本设置

数据来源与参考

  • Docker 官方文档:API versioning 与 docker version(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌