CasaOS 上 Docker 容器起不来或崩溃

简短答案

容器起不来多是镜像没拉全、端口被占、数据卷路径不对、资源不够之一。先看容器日志，八成一眼定位；CasaOS 应用商店装的应用本质也是 Docker 容器，排查方法一致。

按四点定位

点	现象	怎么查
镜像	卡在拉取、起不来	网络 / 镜像加速，重拉
端口	起不来报端口占用	换端口或释放占用
数据卷	起了但数据不对/没数据	检查映射的宿主机目录
资源	反复重启、崩	看内存是否打满、日志 OOM

CasaOS 应用商店的镜像与版本行为以条目页与官方文档为准；手动部署用 Docker 命令时同理。

三个高频原因

1. 镜像拉取失败：网络不稳或没挂加速，重新拉取；仍失败先查 CasaOS 机器网络。
2. 端口冲突：两个应用占了同一宿主机端口，改其中一个的端口映射。
3. 数据目录没映射：容器重启后数据没了——部署时没把宿主机目录映射进去。

CasaOS 的容器能力与 CasaOS 条目页 介绍一致（基于 Docker）；需要更强容器/应用生态可对比 Unraid、OpenMediaVault。基础系统本身有问题时，选发行版的思路可参考 Linux 发行版怎么选；引导进维护环境排查可用 PE 维护系统。

常见误操作

1. 容器一崩就重装应用，不先看日志。
2. 数据没映射进容器，装完就以为数据存好了。
3. 端口撞了还以为是应用坏，反复重启。

操作小结

1. 先 docker logs 看容器日志再动手。
2. 镜像、端口、数据卷、资源按序查。
3. 数据一定要映射出容器本体。
4. 应用生态需求高可对比其他 NAS 系统。

相关链接

• CasaOS
• Linux 发行版怎么选
• PE 维护系统
• Unraid OS