导言：为什么选择CasaOS？
CasaOS是一款轻量级的开源家庭云操作系统，专为智能家居设备管理、数据存储和多媒体共享设计。它支持Docker容器化部署，界面简洁易用，适合新手和极客。把CasaOS安装到vps上也非常容易！
本文亮点：
✅ 全网最新Ubuntu安装CasaOS教程（兼容22.04/24.04）
✅ 详细步骤+避坑指南+卸载CasaOS方法
✅ 附常见问题解决与性能优化建议
一、安装前的准备工作
1. 系统要求
操作系统：Ubuntu 20.04/22.04 LTS（推荐）
硬件配置：
CPU：双核以上（ARM/x86均可）
内存：2GB+（4GB更流畅）
存储：20GB可用空间
网络：需开放端口
80/443（Web访问）和22（SSH）- SSH连接工具：FinalShell或者其他常见连接工具
2. 更新系统与依赖：
# 更新软件源并升级系统（避免兼容性问题）
sudo apt update && sudo apt upgrade -y
# 安装curl和工具链（必须）
sudo apt install curl git wget ufw -y
二、Ubuntu安装CasaOS详细步骤
步骤1：一键安装脚本（官方推荐）
CasaOS提供自动化脚本，5分钟完成部署：
# 执行官方一键安装命令
curl -fsSL https://get.casaos.io | sudo bash
注：若网络不稳定，可替换为国内镜像源：
curl -fsSL https://get.casaos.io | sudo bash -s -- --mirror
看到如下界面自动安装已经完成：
步骤2：防火墙配置（重要！）
开放Web访问端口：可以使用下面命令开启防火墙，有的vps需要在控制面板中的防火墙安全规则中添加；，如阿里云或者腾讯的vps
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable # 启用防火墙
步骤3：验证安装是否成功
方式1：浏览器访问
http://你的UbuntuIP地址方式2：终端查看服务状态
systemctl status casaos.service # 显示“active (running)”即成功
首次浏览器打开访问地址会如图显示：
三、CasaOS初始化设置与功能体验
1. 首次登录配置
设置管理员账号密码
选择存储路径（默认
/DATA目录）绑定域名（可选，需提前解析）
2. 核心功能推荐
应用商店：一键安装Jellyfin、Nextcloud、HomeAssistant等
Docker管理：可视化部署容器（支持Compose编排）
文件共享：SMB/NFS协议支持，跨设备访问
设备监控：实时查看CPU、内存、存储状态
- 安装WEB容器管理软件Portainer
打开Portainer的web界面-安装Docker应用，如常见的alist等应用
四、常见问题与解决方案
问题1：安装脚本卡住或报错
原因：网络连接超时或依赖缺失
解决：
# 重试安装命令，或手动下载离线包
wget https://github.com/IceWhaleTech/CasaOS/releases/download/v0.4.4/casaos-all-0.4.4.tar.gz
tar -zxvf casaos-all-0.4.4.tar.gz && cd casaos && sudo ./install.sh
问题2：无法访问Web界面
排查：
检查防火墙是否放行端口
运行
sudo casaos service status查看服务状态重启服务：
sudo systemctl restart casaos
卸载CasaOS：
要卸载CasaOS，您可以根据CasaOS的版本使用不同的命令：
对于CasaOS v0.3.3或更高版本
打开终端或命令行界面
输入卸载CasaOS的命令
对于v0.3.3或更高版本的CasaOS，您可以使用以下命令来卸载：
casaos-uninstall
或者，如果您想卸载所有相关的容器和镜像，可以使用以下脚本（但请注意，这将删除所有CasaOS容器和镜像，请确保这是您想要的操作）：
curl -fsSL https://get.icewhale.io/casaos-uninstall.sh | sudo bash
执行这个脚本时，系统会提示您是否要删除所有的容器和镜像，确认后继续。
- 执行命令以开始卸载过程
按回车键执行上述命令之一。
- 等待卸载完成
卸载过程可能需要一些时间，具体取决于您系统上CasaOS的安装情况。
结语
通过本教程，您已成功在Ubuntu上部署CasaOS，并掌握了基础配置与安装与卸载，问题排查技巧。CasaOS的模块化设计使其成为家庭云和智能家居管理的理想选择。立即行动，打造您的私人智能中心吧！
