先说结论
将 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 尚未适配此变更。
解决方案:
目前可通过以下两种方式临时解决:
补充说明:
Portainer 官方已确认该兼容性问题,正在开发永久性修复方案。若需维持 Docker 29 运行环境,可参考官方文档通过配置 DOCKER_API_MIN_VERSION 参数指定兼容的 API 版本(需谨慎操作)。

