CasaOS · 面向家庭场景的自托管个人云系统｜一键部署与使用全指南
项目仓库： https://github.com/IceWhaleTech/CasaOS
开源协议：见仓库 LICENSE · 定位：家庭服务器/个人云 ·
安装：wget -qO- https://get.casaos.io | sudo bash ·
架构：amd64 / arm64 / armv7 · 官方支持：Debian 12、Ubuntu Server
20.04、Raspberry Pi OS
1 项目简介
CasaOS 是一个面向家庭场景设计的开源个人云操作系统，提供友好 UI，无需代码即可管理家庭服务器。它支持 ZimaBoard、Intel NUC、树莓派及旧电脑，内置应用商店一键安装 Nextcloud、HomeAssistant、AdGuard、Jellyfin 等，并可轻松安装 Docker 生态中 10 万+ 应用。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | CasaOS |
| 仓库地址 | github.com/IceWhaleTech/CasaOS |
| 项目定位 | 家庭场景自托管个人云 |
| 安装命令 | `wget -qO- https://get.casaos.io |
| 架构 | amd64 / arm64 / armv7 |
| 官方支持系统 | Debian 12（推荐）、Ubuntu Server 20.04、Raspberry Pi OS |
| 更新命令 | `wget -qO- https://get.casaos.io/update |
1.2 适用场景
- 用旧电脑/NUC/树莓派搭家庭服务器。
- 一键部署 Nextcloud、Jellyfin、AdGuard 等自托管应用。
- 需要可视化的磁盘/文件与应用管理。
1.3 能力边界（官方口径）
- 官方测试通过 Debian 12、Ubuntu 20.04、Raspberry Pi OS。
- Alpine/OpenWrt/ArchLinux 仍为社区支持，未完全测试。
2 功能特性
- 友好 UI：面向家庭场景，无代码、无表单。
- 多硬件支持：ZimaBoard、NUC、RPi、旧电脑。
- 应用商店：精选应用一键安装（Nextcloud、HomeAssistant、AdGuard、Jellyfin 等）。
- Docker 应用：轻松安装 Docker 生态 10 万+ 应用。
- 磁盘与文件管理：所见即所得。
- 系统/应用小部件：资源占用、应用状态一览。
3 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/IceWhaleTech/CasaOS | 源码 |
| 安装脚本 | get.casaos.io | 一键安装 |
4 方式一：一键安装（官方推荐）
在 freshly 安装的支持系统上执行：
wget -qO- https://get.casaos.io | sudo bash或用 curl：
curl -fsSL https://get.casaos.io | sudo bash5 更新与卸载
# 更新
wget -qO- https://get.casaos.io/update | sudo bash
# 卸载
casaos-uninstall
# 或
curl -fsSL https://get.icewhale.io/casaos-uninstall.sh | sudo bash6 配置与硬件要求
| 项 | 说明 |
|---|---|
| 架构 | amd64 / arm64 / armv7 |
| 官方支持 | Debian 12（推荐）、Ubuntu Server 20.04、Raspberry Pi OS |
| 社区支持 | Elementary、Armbian、Alpine、OpenWrt、ArchLinux |
7 常见故障排查
- 安装失败：确认系统为官方支持版本、网络可访问 get.casaos.io。
- 架构不匹配：确认设备为 amd64/arm64/armv7。
- 应用装不上：依赖 Docker，先确认 Docker 服务正常。
8 风险与说明
- 许可证：以仓库 LICENSE 为准。
- 数据安全：自托管数据请自行备份。
- 非官方声明：本文基于官方仓库 README 整理，命令以 master 分支最新为准。