CasaOS 介绍与选型指南

目标：全面认识 CasaOS 这款基于 Docker 的开源家庭云操作系统，掌握其定位、核心架构、功能特性与安装路径，并能在与 Portainer、1Panel、umbrelOS、Runtipi、YunoHost 等同类面板之间做出量化选型。本文信息来源均已在文中标注（官方站点、GitHub 仓库与 shields.io 徽章接口，查询日期 2026-10-21）。

一、环境信息

本文为认知与选型篇，内容以公开资料溯源为主，引用来源与查询日期如下：

• 软件名称：CasaOS（西语/意大利语中"Casa"意为"家"，即"家的操作系统"）
• 开发与维护方：IceWhale Technology（ZimaBoard 硬件厂商），GitHub 组织 IceWhaleTech
• 官方仓库：https://github.com/IceWhaleTech/CasaOS
• 官方文档站（Wiki）：https://wiki.casaos.io
• 官方安装脚本域名：get.casaos.io
• 最新稳定版本：v0.4.15（GitHub Releases 实查，release 创建时间 2024-12-20T18:49:00Z，查询日期 2026-10-21）
• 最新预发布版本：v0.4.17-alpha1（Pre-release，引入 RISC-V 初始支持，查询日期 2026-10-21）
• 开源许可证：Apache-2.0（shields.io License 徽章接口实查，查询日期 2026-10-21）
• 社区规模：约 37k Stars（shields.io Stars 徽章接口实查，查询日期 2026-10-21）
• 官方支持系统：Debian 12（✅ 官方测试并推荐）、Ubuntu Server 20.04（✅ 官方测试）、Raspberry Pi OS（✅ 官方测试）；社区测试 Elementary 6.1、Armbian 22.04；Alpine、OpenWrt 尚未完全测试（来源：wiki.casaos.io Get Started，查询日期 2026-10-21）
• 硬件架构支持：amd64 / x86-64、arm64、armv7（来源：wiki.casaos.io Get Started，查询日期 2026-10-21）

二、软件概述

CasaOS 是 IceWhale Technology 发起的社区开源项目，定位是交付简单家庭云体验（delivering simple home cloud experience）的轻量级操作系统面板（来源：wiki.casaos.io 首页，查询日期 2026-10-21）。它并不替代底层 Linux 发行版，而是安装在 Debian、Ubuntu、Raspberry Pi OS 等已有系统之上的一套 Web 管理面板：一条安装命令即可把一台旧电脑、单板计算机（ZimaBoard、树莓派、Intel NUC 等）变成一台可以通过浏览器管理的"家庭云主机"。

其技术形态可以概括为三点：

1. Docker 原生的应用面板：CasaOS 把所有第三方应用（Jellyfin、Home Assistant、Nextcloud、qBittorrent 等数百个）以 Docker 应用（Docker Compose 编排）的形式一键部署与管理，应用商店即 Docker 应用仓库。
2. 微服务化的 Go 后端：主服务、网关、消息总线、用户服务、本地存储、应用管理等多个独立进程通过 systemd 托管、经内置网关统一转发，Web 前端为 Vue 单页应用。
3. 面向家庭/轻办公场景：强调"开箱即用"——首次安装向导、应用商店一键装、文件管理、磁盘与系统状态可视化，面向非专业用户而非运维团队。

💡 技术拓展：同为"Docker 可视化面板"，业界有三类定位不同的产品——

类型	代表	特点	适用场景
Docker 管理型面板	Portainer	以 Docker 应用/栈/集群为管理对象，偏运维视角	团队管理 Docker/K8s
家庭云应用面板	CasaOS、umbrelOS、Runtipi	以"应用商店装 App"为中心，偏生活视角	家庭 NAS、家庭自动化
服务器综合运维面板	1Panel、Webmin、Cockpit	覆盖网站/数据库/防火墙/计划任务等系统运维	个人服务器与建站运维

CasaOS 属于第二类：它不追求运行时级别的精细管控（那是 Portainer 的强项），而是把"装应用、管文件、看状态"做到最简。

三、核心架构

CasaOS v0.4.15 采用微服务拆分 + 统一网关的架构，各组件均为独立 systemd 服务（来源：GitHub 组织 IceWhaleTech 下各组件仓库与主仓库 releases 发行件结构，查询日期 2026-10-21）：

架构运转的关键机制有三处：

• 服务发现与路由：各后端服务启动时把自己可访问的地址写入 /var/run/casaos/*.url，网关聚合为路由表；主服务每次重启端口随机变化，网关靠该机制动态跟随。
• 消息总线：UI 与各服务通过 WebSocket（/v2/message_bus 路由）订阅事件，如 app:install-progress、local-storage:disk:added，实现安装进度条、磁盘热插拔通知等实时体验。
• 应用商店：默认内置官方商店源（https://casaos.app/store/main.zip），并预置社区商店源（BigBearTechWorld），商店数据落地在 /var/lib/casaos/appstore，应用以 Docker Compose 工程形式部署在 /var/lib/casaos/apps。

四、功能特性

综合官方仓库 README 与 Wiki（查询日期 2026-10-21），CasaOS 的核心功能如下：

1. 应用商店（App Store）：数百个常用自托管应用的一键安装/升级/卸载，支持自定义 Docker Compose 应用与第三方商店源注册。
2. 文件管理：内置 Web 文件管理器，支持文件上传下载、剪切/复制/重命名/分享链接；配合 rclone 支持云驱动挂载。
3. 系统状态监控：CPU、内存、磁盘、网络 I/O 的仪表盘展示。
4. 磁盘与存储管理：磁盘格式化挂载向导、USB 自动挂载、mergerFS 多盘合并。
5. 系统终端：WebUI 内置终端，可直接执行命令。
6. 消息通知与应用进度：应用安装/升级进度实时推送到 UI。
7. 移动端适配：v0.4.15 更新日志明确包含"移动端显示布局优化"（来源：GET /v1/sys/version 接口 changelog，查询日期 2026-10-21）。
8. 多架构发行件：amd64、arm64、armv7 官方发行，v0.4.17-alpha1 开始引入 RISC-V 支持。

五、快速开始（最小可用示例）

官方推荐的安装方式是一键脚本（来源：wiki.casaos.io Get Started，查询日期 2026-10-21）。在一台已联网、有 systemd 的目标主机（Debian 12 / Ubuntu 等）上执行：

wget -qO- https://get.casaos.io | sudo bash
# 或
curl -fsSL https://get.casaos.io | sudo bash

脚本会自动检测硬件架构与发行版、安装 Docker（如缺失）、下载各组件发行包并注册 systemd 服务，完成后输出 WebUI 访问地址（默认 80 端口）。随后浏览器访问 http://<主机IP> 即可进入首次设置向导，创建管理员账户后进入仪表盘。

详细的分步安装（含系统要求、离线安装、验证与排障）见本专栏《Ubuntu 22.04 安装 CasaOS 0.4.15 指南》。

六、适用场景与限制

适合的场景：

• 家庭 NAS / 家庭服务器：旧电脑或 ZimaBoard、树莓派等设备安装后作为家庭应用中心（影音、相册、下载、家庭自动化）。
• 非技术用户的自托管入门：图形化应用商店 + 首次向导，无需掌握 Docker 命令即可装应用。
• 单机轻办公/实验室演示：快速拉起一组 Web 应用做内网演示。

限制与短板（选型前必须知晓）：

• 单机定位，无集群/多机管理：不支持多节点编排，管理多台主机需在每台上各装一套。
• 应用隔离粒度粗：所有应用共用宿主 Docker，面板不提供运行时级资源配额、Registry 仓库管理等高级管控，需要细粒度治理时应选 Portainer。
• 版本节奏偏慢：稳定版更新以小步修 bug 为主（v0.4.13→v0.4.15 间隔数月），CLI（casaos-cli）与主服务版本存在脱节，部分 CLI 子命令在 v0.4.15 上不可用。
• 默认明文 HTTP：默认 80 端口无 TLS，面向公网暴露需自行前置反代与证书。
• 官方测试系统范围窄：官方完整测试 Debian 12、Ubuntu Server 20.04、Raspberry Pi OS；Ubuntu 22.04 等版本属社区广泛使用但不在官方测试清单（wiki.casaos.io Get Started，查询日期 2026-10-21）。

七、同类选型对比

从社区活跃度、版本节奏、许可证、兼容矩阵与功能形态五个维度，对同类开源面板做量化对比（星数与许可证均取自 shields.io 徽章接口，查询日期 2026-10-21；版本节奏取自各项目 GitHub Releases，查询日期 2026-10-21）：

关键差异与选型建议：

• 如果目标是给家庭/非技术用户一台"装 App 就能用"的家庭服务器，CasaOS、umbrelOS、Runtipi 三者同型：CasaOS 星数最高、多架构发行件最全（amd64/arm64/armv7），社区商店（BigBearTechWorld）补充了官方源之外的大量应用；umbrelOS 生态应用偏加密货币/生活向；Runtipi 迭代更快但历史较短。
• 如果目标是管理既有 Docker/K8s 资产的运维控制台，选 Portainer：它是唯一支持集群与细粒度 RBAC 的选项，但应用商店体验不是它的设计中心，且 Zlib 许可证对商用分发有限制条款。
• 如果目标是一台 Linux 服务器的综合运维（建站、数据库、防火墙、监控），1Panel 更合适，其覆盖面远超 CasaOS 的家庭云定位。
• 如果需要邮件/VPN/备份等系统级全家桶集成（而非 Docker 应用），YunoHost 的自有包体系更完整，但学习曲线也更高。
• CasaOS 的 Apache-2.0 许可证在六者中对二次分发与商用最宽松，这也是大量 NAS 整机厂商与 ZimaOS 选择其作为基础的原因之一。

八、参考链接

1. CasaOS 官方仓库：https://github.com/IceWhaleTech/CasaOS
2. CasaOS 官方 Wiki（Get Started / Guides / Troubleshooting）：https://wiki.casaos.io
3. CasaOS Releases（版本与变更记录）：https://github.com/IceWhaleTech/CasaOS/releases
4. CasaOS 一键安装脚本：https://get.casaos.io
5. 官方应用商店源：https://casaos.app/store/main.zip
6. 社区应用商店（BigBearTechWorld）：https://github.com/bigbeartechworld/big-bear-casaos
7. IceWhale 官方硬件（ZimaBoard）：https://www.zimaboard.com
8. 本专栏安装实战：《Ubuntu 22.04 安装 CasaOS 0.4.15 指南》

• 本专栏系列：《CasaOS 0.4.15 常用 CLI 命令与工具详解》。

• 本专栏系列：《CasaOS 0.4.15 配置参数详解》。