先说结论

将 Docker 从 29.0.0 降级到 28.5.2 或者 将 portainer 降级到 2.20.2

问题表现


进入 Portainer 时显示连接状态为"UP",但点击操作时提示连接失败(Down)。

(图片来源于网络,侵权请联系我删除)

根本原因


经排查,该问题源于 Docker 29.0.0 版本对 API 最低版本规则的重大变更,导致其与 Portainer 最新版存在兼容性冲突(详见 GitHub Issue #12925)。核心原因是 Docker 29 强制升级了最低 API 版本要求,而 Portainer 尚未适配此变更。

解决方案


目前可通过以下两种方式临时解决:

  1. 降级 Docker 版本
    将 Docker 从 29.0.0 回退至 28.5.2 稳定版本。
  2. 降级 Portainer 版本
    将 Portainer 降至 2.20.2 兼容版本。

补充说明


Portainer 官方已确认该兼容性问题,正在开发永久性修复方案。若需维持 Docker 29 运行环境,可参考官方文档通过配置 DOCKER_API_MIN_VERSION 参数指定兼容的 API 版本(需谨慎操作)。

Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐