前几天有位朋友问我：家里的 CasaOS 一直跑得好好的，顺手 apt upgrade 了一下系统，重启后面板里的应用列表全没了，反复刷新只剩一句"Failed to load apps, please refresh later"。GitHub他以为自己把系统搞坏了，差点准备重装。
先给结论：不是你的操作问题，数据也没丢。这是 Docker 29 和 CasaOS 的一次兼容性事故，从 2025 年 11 月闹到现在已经 9 个月，官方核心代码至今没修。好消息是，社区早就验证出了靠谱的修法，快的话 2 分钟搞定。GitHub
先吃个定心丸：容器还在跑，只是面板"失明"了
发现应用列表空了之后，很多人第一反应是"完了，NAS 挂了"。其实不是。官方工作人员在 issue 里确认过：Docker 里的容器一切照常，网盘、影音、下载任务都在正常运行，只是 CasaOS 的面板看不到它们、也没法再装新应用。GitHub换句话说，这是"仪表盘失灵"，不是"发动机熄火"。数据是安全的，先别急着重装系统。
事情是怎么发生的：一条时间线
我把 GitHub、B站两边的讨论翻了一遍，整个过程是这样的：
2025 年 11 月 11 日：Docker 通过 apt 推送 29 版本。当天 CasaOS 仓库就涌入大量相同报告，issue #2390 里有人留下一句"CasaOS 需要 Docker API 1.44+"，点破了问题方向。GitHub
2025 年 11 月 14 日：有用户在 issue #2407 里给出了解法——给 Docker 服务加一个环境变量 DOCKER_MIN_API_VERSION=1.24，评论区二十多条回复清一色"work for me"“genius”。GitHub
2025 年 11 月 19 日：B站 UP 主@谢雨枫 发布处理视频，91 条评论里全是"还好没更新""我直接卸载重装旧版 Docker"的同病相怜。哔哩哔哩
2025 年 12 月 10 日：CasaOS 官方人员回复：安装脚本已修复，重新执行官方脚本或全新安装可以解决。
但注意，修的是"安装脚本"，不是 CasaOS 本体。CasaOS 核心代码的最后一个正式版还停在 2024 年 12 月的 v0.4.15，最后一次 release 是 2025 年 4 月的 v0.4.17-alpha1。
2026 年 2 月，issue 下有用户忍不住问："三个月了连个 assign 都没有，CasaOS 是不是停摆了？“也有人留言"我迁移到 Umbrel 了，再见 CasaOS”。
2026 年 7 月 28 日：仍有新用户提交"Failed to load apps"的反馈——也就是说，现在入坑的人照样会踩。
2026 年 8 月 13 日：有开发者留言"我 fork 并修好了"，他维护的分支两天内连续推到了 v0.4.28，不过目前只有 1 个 star，能不能持续还要观察。
为什么会坏：一个"方言"问题
用大白话解释一下根因。
CasaOS 的面板要管理 Docker，得通过 Docker 的 API 跟它"对话"。Docker 29 这次升级干了一件事：把服务端能听懂的最低 API 版本抬高到了 1.44，更老的"方言"直接拒收。
问题在于，CasaOS 内置的 Docker 客户端还是老版本，说的恰恰是被拒收的老方言。于是面板发的每个请求都被 Docker 挡回来，应用列表自然加载不出来。
Docker 官方其实留了个后门：通过环境变量 DOCKER_MIN_API_VERSION 可以把最低接受版本降回去。社区的解法就是利用这个后门，让 Docker 重新"听得懂" CasaOS。
顺带一提，被 Docker 29 波及的不止 CasaOS。B站评论区里有人反馈 watchtower、Bitwarden 这类老镜像也出了问题，前者可以换社区 fork 的镜像，后者换 vaultwarden 就能解决。哔哩哔哩如果你升级后面板之外还有别的服务异常，可以往这个方向排查。
三条修复路线，怎么选
路线一：加环境变量（推荐，最省事）
适合绝大多数人，不用降级 Docker，2 分钟搞定：
```
sudo systemctl edit docker.service
```
在打开的文件里、### 提示行的上方加入：
```
[Service]
Environment=DOCKER_MIN_API_VERSION=1.24
```
保存退出后执行：
```
sudo systemctl daemon-reload && sudo systemctl restart docker
```
刷新 CasaOS 面板，应用应该回来了。这条路线在 GitHub issue 里被验证的次数最多，也是 CasaOS 官方安装脚本现在内置的同款方案。GitHub有个小坑提醒：有用户改了不生效，最后发现是编辑的文件位置不对，确认改的是 systemctl edit 打开的那个 override 文件。
路线二：回退 Docker 到 28.5.2
适合不想动配置、追求"回到已知稳定版"的人。思路是停掉 docker 和 docker.socket，安装指定版本的 docker-ce（Ubuntu 24.04 是 5:28.5.2-1~ubuntu.24.04~noble，其他发行版换对应版本号），再执行 apt-mark hold docker-ce docker-ce-cli containerd.io 锁住版本，防止下次升级又被顶上去。
B站也有人是降级到更老的 25.x 修好的，能用，但没必要退那么远，28.5.2 就够了。哔哩哔哩GitHub
路线三：重跑官方安装脚本
官方在 2025 年 12 月修复的安装脚本里已经内置了 API 兼容处理（我核对了 get.casaos.io 的脚本源码，确实有一段 Apply_Docker_API_Override，干的就是写入 DOCKER_MIN_API_VERSION=1.24 这件事）。官方人员的说法是：重跑当前安装脚本就能修复之前装坏的实例。GitHub适合本来就想重整理一遍环境的人，追求稳妥的话路线一更直接。
修完之后：把这条教训固定下来
这次事故真正的教训不是"某个 Bug 真烦"，而是：CasaOS 这类面板对 Docker 版本敏感，而系统的包管理器升级时不会给你任何提醒。
所以修好之后建议多做一步：
```
sudo apt-mark hold docker-ce docker-ce-cli containerd.io
```
把 Docker 相关包锁住，以后 apt upgrade 不会再悄悄把它顶上新版本。想升级时先手动升、升完看看面板正不正常，心里有底。
对家里跑 NAS 的设备，社区里一条高赞经验值得记住：“还好平时不更新”——稳定运行的家庭服务器，升级前先去 issue 区、B站、论坛搜一圈，确认没人踩雷再动手，永远不亏。哔哩哔哩
还没装的人，看这里
如果你还没装 CasaOS、正准备照教程来一遍：2025 年 12 月之后走官方脚本 get.casaos.io 全新安装的，脚本已经内置了兼容处理，不会踩这个坑。但装完同样建议锁一下 Docker 版本，另外装第三方商店源之前，记得先掂量来源靠不靠谱。
最后说两句不那么"教程"的话。这次事故像一面镜子，照出了 CasaOS 眼下的真实状态：官方团队的精力明显在自家的 ZimaOS 上（那边 8 月 17 日还在发新 beta），CasaOS 核心九个月没动，出了问题靠社区自救、靠 fork 接力。GitHubGitHub这不影响它"37k star、旧电脑变 NAS 最省事方案之一"的地位，但你得知道：用它，某种程度上就是在和一群热心用户一起"共同维护"这套系统。
能接受这一点，CasaOS 依然是低成本入门家庭云的好选择；接受不了，趁早看看 fnOS 这类更新勤快的方案，别等面板黑了才后悔。
