常见问题 CasaOS安装失败排错
CasaOS 安装卡住或中途失败，常见卡点排查
CasaOS 安装卡在下载、脚本执行或首次进界面时的常见卡点，按「基础系统、Docker、网络」三段排查，给出快速定位方法。
发布于 2026/11/14
所属频道 装机通用常识
本文目录 点击展开
简短答案
CasaOS 装在基础系统之上，安装卡住九成卡在基础系统没装好、Docker 没装好、网络拉不动镜像这三段。逐段排查比从头重装快得多。
按三段定位卡点
| 阶段 | 典型现象 | 先查什么 |
|---|---|---|
| 基础系统 | 装机盘都进不去 | 启动模式、ISO 完整性 |
| CasaOS 脚本 | 卡在下载/拉取 | 网络、代理、源 |
| 首次进界面 | 页面打不开 | 地址、端口、防火墙 |
各阶段细节与版本行为以官方文档为准；脚本地址以 CasaOS 条目页 为准，别用老教程里的链接。
三个高频卡点
- Docker 没装或版本过旧：脚本执行前
docker version验证，Docker 起不来 CasaOS 必然卡。 - 网络拉不动：脚本要拉取镜像，国内网络不稳会长时间不动；挂代理或换源后重跑。
- 基础系统镜像本身有问题：换官方源重新下载基础系统 ISO，写盘参考 Rufus 条目页，不确定镜像好坏先到 搜索页 找可校验的源。
CasaOS 依赖基础 Linux 系统，系统怎么选可先读 Linux 发行版怎么选，别图省事用带预装软件的封装版。
常见误操作
- 网络一卡就判定 CasaOS 坏，其实只是下载慢，给足时间或挂代理。
- 在没装好 Docker 的机器上直接跑安装脚本。
- 用第三方封装版基础系统装 CasaOS，后续排错全被封装版干扰。
操作小结
- 先分清卡在哪一段：基础系统 / 脚本 / 进界面。
docker version验证 Docker，再看网络与代理。- 镜像与脚本地址都以官方/条目页为准。
- 重装前先把基础系统镜像重新下载并校验。