常见问题 ReCasaOSCasaOSDocker容器排错
ReCasaOS 上 Docker 容器起不来或崩溃
按「镜像拉取 → 端口冲突 → 资源不足 → 配置漂移」顺序排查 ReCasaOS 上容器起不来或反复崩溃的原因，并给出数据卷与配置的检查点。
发布于 2026/11/14
所属频道 装机通用常识
本文目录 点击展开
简短答案
容器起不来或反复崩溃，按「镜像拉取 → 端口冲突 → 资源不足 → 配置漂移」顺序查。应用商店一键部署省掉了前两步的一半，但自定义容器与更新后的应用仍会撞上端口与配置问题。
四段排查
| 段 | 现象 | 处理 |
|---|---|---|
| 1. 拉取 | 卡在「下载镜像」 | 换网络时段、检查 DNS；国内拉取慢可配加速，以官方文档为准 |
| 2. 端口 | 报「端口已被占用」 | 在 Web 界面看哪些应用占了该端口，改空闲端口 |
| 3. 资源 | 反复重启、OOM | 看内存占用，停掉不用的容器；资源上限见「硬件要求」一文 |
| 4. 配置 | 更新后起不来 | 对比更新前后配置目录，恢复备份过的配置 |
容器崩溃的根因有时在数据卷：卷所在盘不健康时，容器表现是「时好时坏」。盘健康问题先按 FAQ「识别不到硬盘」一文排除。
数据卷与配置两个检查点
- 数据卷路径还在不在：换盘、扩容、重装后挂载点可能变，容器配置里指向旧路径就会起不来（挂载关系见「初始化存储池」一文）。
- 配置目录是否被覆盖：应用更新前备份配置目录，出问题先还原；备份方法见「快照与备份」一文。
ReCasaOS 的容器管理是轻量路线，深度容器编排需求对照 Linux 发行版 一文了解其他系统差异；Unraid OS 把容器当一等公民做，能力边界各系统以条目页为准。需要进系统层排查时，进系统入口参考 PE 工具页。
常见误操作
- 端口冲突就无脑改端口，不查是谁占着，改完又撞别的。
- 容器崩了反复点「启动」，不停容器、不备份配置，越弄越脏。
- 把拉取慢当镜像坏了，反复删了重拉。
排障前的信息清单
排查前先把这几项截图/抄下来，效率翻倍：
- 应用名、镜像名与拉取状态。
- 容器日志最后 20 行（Web 界面「日志」入口）。
- 当前占用的端口、数据卷路径。
- 最近一次正常运行的时间点。