## 前言
CasaOS是一个轻量级家庭云系统，界面美观、操作简单，让旧电脑秒变家庭服务器——装应用、管文件、看视频，全图形化操作！本教程零基础手把手教你安装。
## 一、CasaOS是什么？
CasaOS是一个开源的家庭云操作系统：
– 图形化界面，像手机一样装应用
– 内置应用商店，一键安装Docker应用
– 支持文件管理、照片管理、媒体播放
– 轻量，2GB内存就能跑
– 完全免费开源
## 二、环境准备
### 2.1 硬件要求
| 项目 | 最低要求 | 推荐 |
|——|———|——|
| CPU | 双核x86 | 四核及以上 |
| 内存 | 2GB | 4GB及以上 |
| 硬盘 | 32GB | 64GB以上 |
| 系统 | Debian 11 / Ubuntu 20.04 | Debian 12 |
### 2.2 先安装Docker
CasaOS依赖Docker，必须先安装：
curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker
验证：docker –version
## 三、一键安装CasaOS
SSH连接你的设备，执行：
curl -fsSL https://get.casaos.io | sudo bash
安装约2-5分钟，完成后显示访问地址。
## 四、初始化配置
1. 浏览器访问 http://设备IP:80
2. 创建管理员账号密码
3. 进入主界面
## 五、安装应用
1. 点击App Store（应用商店）
2. 浏览或搜索需要的应用
3. 点击Install一键安装
4. 常用推荐：Jellyfin（媒体）、Nextcloud（网盘）、Alist（文件管理）
## 六、文件管理
CasaOS内置文件管理器：
– 上传/下载/预览文件
– 创建共享链接
– 照片自动归类
## 七、常见报错解决
| 报错 | 原因 | 解决方案 |
|——|——|———|
| 安装脚本空白 | 国内网络问题 | 配代理或换网络 |
| Docker依赖缺失 | Docker未安装 | 先安装Docker再装CasaOS |
| Alpine安装失败 | 系统不兼容 | 换Debian或Ubuntu |
| 应用安装失败 | Docker镜像拉不动 | 配置Docker镜像加速器 |
| 80端口被占 | 其他服务占用 | 停掉占用的服务 |
## 八、避坑总结
1. 必须先装Docker，CasaOS所有应用都基于Docker
2. 国内网络建议先配Docker镜像加速器
3. 推荐用Debian系统，兼容性最好
4. 2GB内存可以跑，但建议4GB以上
5. 卸载命令：casaos-uninstall
本教程由技术保姆网原创，转载请注明出处。