1. 先搞清楚 CasaOS 到底是什么以及它和传统 NAS 系统有什么不同如果你在找一款能快速把家里闲置的电脑、旧笔记本甚至树莓派变成个人云存储和轻量应用服务器的系统那 CasaOS 值得你花时间了解一下。它不是传统意义上像群晖 DSM 或 TrueNAS 那样庞大、复杂的 NAS 操作系统而是一个轻量、开源的“家庭云操作系统”核心目标是让搭建和管理个人数据与应用服务变得像用手机 App 一样简单。很多人第一次接触 CasaOS 会困惑它到底是个完整的操作系统还是一个管理面板简单说它更像一个运行在 Linux 之上的、高度集成的 Web 管理界面和应用商店。你不需要懂复杂的 Docker 命令、网络配置和存储挂载通过 CasaOS 的图形界面就能完成硬盘共享、Docker 容器部署、文件管理这些核心操作。它的价值在于极大地降低了个人和小团队搭建私有云服务的门槛特别适合想折腾但又怕麻烦的开发者、影音爱好者或家庭用户。和传统方案相比CasaOS 有几个明显的差异点第一是安装极其简单通常一条命令就能完成第二是应用生态围绕 Docker 构建通过其自带的“App Store”实际上是 Docker 镜像的图形化封装可以一键部署 Nextcloud、Jellyfin、Home Assistant 等上百种常用服务第三是界面设计更现代化、直观资源监控、文件浏览、应用管理都在一个面板里完成。所以如果你需要的不是一个企业级、多用户、带高级 RAID 和备份策略的存储服务器而是一个能快速上手的个人数据与媒体中心CasaOS 是一个高效的选择。2. 安装前的准备硬件、系统与网络环境在动手安装之前先确认你的环境是否合适。CasaOS 对硬件要求非常宽松但这不意味着所有设备都能获得最佳体验。2.1 硬件与系统要求主机设备x86-64 架构的旧电脑、迷你主机、Intel NUC或者 ARM 架构的树莓派3B 及以上、Orange Pi 等开发板都可以。性能主要影响你后续能流畅运行多少个 Docker 应用。内存最低 1GB建议 2GB 或以上。如果你计划运行数据库如 MySQL、媒体服务器如 Jellyfin 转码或多个应用4GB 是更稳妥的起点。存储这是核心。你需要至少一块硬盘用于安装系统通常 16GB 以上的 SSD 或 U 盘即可以及一块或多块大容量硬盘用于存储数据。数据盘可以是内置的 SATA 硬盘、外置的 USB 硬盘甚至是网络存储NFS/SMB。关键点CasaOS 本身很小它管理的是你挂载上去的存储空间。操作系统CasaOS 必须安装在 Linux 系统上。它不支持直接安装在 Windows 或 macOS 上也不支持安装在其它 NAS 系统如 DSM、TrueNAS内部。官方主要支持以下发行版Ubuntu 20.04 / 22.04Debian 11 / 12Raspberry Pi OS (基于 Debian)理论上其他基于 systemd 的较新 Linux 发行版也可行但可能遇到依赖问题。我的建议是对于新手优先选择Ubuntu Server 22.04 LTS或Debian 11作为底层系统。它们社区支持好遇到问题容易搜索到解决方案。如果你用树莓派就用最新的 Raspberry Pi OS Lite无桌面版。2.2 网络环境准备网络配置是后续能否顺利访问和使用的关键。固定 IP 地址强烈推荐给你的 CasaOS 主机在路由器里设置一个静态 IP或 DHCP 保留。这样它的内网地址就不会变方便你通过浏览器访问如http://192.168.1.100。动态 IP 会导致你经常需要重新查找地址。主机名安装 Linux 系统时可以设置一个简单易记的主机名比如casaos、nas。端口考虑CasaOS 默认使用80端口HTTP提供 Web 界面。确保主机防火墙如ufw和路由器没有阻止这个端口的入站连接。如果 80 端口被占用安装脚本通常会提示或自动处理。2.3 安装底层 Linux 系统这是 CasaOS 安装的前提。以 Ubuntu Server 22.04 为例从官网下载镜像制作启动 U 盘。在目标设备上启动安装程序。在安装类型选择时选“最小化安装”或“基本 Ubuntu Server”即可不需要桌面环境。在磁盘分区时如果你有单独的系统盘和数据盘建议将系统安装在较小的 SSD/U 盘上而将大容量数据盘先不分区、不格式化留给 CasaOS 后续管理。如果只有一块大盘可以手动分区划出一个小分区如 30-50GB给系统剩余空间留空。务必设置一个非 root 的日常用户并记住密码。安装完成后通过ssh your_usernameyour_host_ip登录系统进行系统更新sudo apt update sudo apt upgrade -y。完成以上步骤一个干净、准备好的 Linux 服务器就绪了。3. 核心安装流程与国内源配置CasaOS 的安装以“一键脚本”闻名但在国内网络环境下直接使用官方脚本可能会因为网络问题导致安装失败或极慢。下面分步拆解。3.1 标准安装命令与原理官方推荐的安装命令是curl -fsSL https://get.casaos.io | sudo bash这条命令做了以下几件事curl下载位于https://get.casaos.io的安装脚本。通过管道|将脚本内容传递给sudo bash执行。脚本会自动检测你的系统架构x86_64, arm64, armv7h然后从 GitHub 等官方源下载对应的 CasaOS 安装包和 Docker 镜像。问题在于https://get.casaos.io的脚本以及后续从 GitHub、Docker Hub 拉取资源在国内可能速度很慢或连接不稳定。这就是为什么需要“国内源”。3.2 使用国内源加速安装国内开发者社区提供了镜像源将安装脚本和所需的软件包、Docker 镜像缓存到了国内服务器。目前比较稳定的是由iLemon等人维护的源。安装命令变为curl -fsSL https://get.icewhale.io/casaos.sh | sudo bash或者更具体地指定版本和源curl -fsSL https://gitclone.com/ithub.com/IceWhaleTech/get/raw/master/casaos.sh | sudo bash执行后你会看到什么 脚本会先更新系统包列表安装一些必要依赖如curl,wget,fdisk然后提示你安装 Docker如果系统没有。接着它会从国内镜像站下载 CasaOS 的deb包对于 Debian/Ubuntu并进行安装。整个过程通常会在几分钟内完成远快于从国外源拉取。安装完成标志脚本最后会输出类似这样的信息CasaOS 安装成功 访问地址: http://你的主机IP 默认用户名: (通常为空首次访问设置) 默认密码: (通常为空首次访问设置)3.3 安装后的首要操作打开浏览器访问在局域网内的另一台电脑或手机上打开浏览器输入http://你的主机IP。你会看到 CasaOS 的初始化设置界面。初始化设置按照提示设置系统语言、时区并最重要的一步——创建管理员账户和密码。请务必记住这个密码。完成向导之后可能会有一个快速向导引导你添加存储、发现设备等可以先跳过我们后面手动配置。至此CasaOS 的核心系统就安装并运行起来了。你可以看到一个仪表盘显示 CPU、内存、存储和网络的基本信息。4. 核心功能实操共享硬盘、部署应用与文件管理安装只是开始让 CasaOS 发挥价值在于配置。下面围绕最常被搜索的“共享硬盘”和“部署应用”展开。4.1 如何共享硬盘添加存储这是 CasaOS 作为“个人云”的基础。这里的“共享”有两层含义一是将硬盘挂载给 CasaOS 系统管理二是将这些存储空间以 SMB/NFS 协议共享给局域网内其他设备访问。步骤 1在 Linux 中初始化和挂载硬盘假设你有一块全新的、未格式化的硬盘/dev/sdb请用sudo fdisk -l或lsblk确认你的硬盘设备号。# 1. 对硬盘进行分区创建一个占用全部空间的主分区 sudo fdisk /dev/sdb # 在 fdisk 交互界面内依次输入n (新建), p (主分区), 1 (分区号), 回车 (起始扇区), 回车 (结束扇区), w (写入并退出) # 2. 格式化分区为 ext4 文件系统兼容性好 sudo mkfs.ext4 /dev/sdb1 # 3. 创建一个挂载点目录 sudo mkdir -p /mnt/mydata # 4. 临时挂载测试是否成功 sudo mount /dev/sdb1 /mnt/mydata df -h | grep mydata # 查看是否挂载成功 # 5. 设置开机自动挂载 # 先获取分区的 UUID sudo blkid | grep /dev/sdb1 # 输出类似/dev/sdb1: UUIDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx TYPEext4 # 编辑 /etc/fstab 文件在末尾添加一行 echo UUIDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/mydata ext4 defaults 0 0 | sudo tee -a /etc/fstab # 测试 fstab 配置是否正确 sudo mount -a完成这步后硬盘就在 Linux 系统中可用了。步骤 2在 CasaOS 中添加此存储进入 CasaOS Web 界面。左侧导航栏点击“存储”。点击“添加存储”按钮。在路径中输入或选择你刚刚创建的挂载点例如/mnt/mydata。给它起一个易记的名字比如 “MediaDrive”。点击添加。CasaOS 会扫描该目录并将其纳入管理。步骤 3创建网络共享SMB在“存储”页面找到你刚添加的 “MediaDrive”点击其右侧的“共享”图标或三个点菜单里的“共享”选项。在共享设置中你可以启用 SMB 共享这是 Windows、macOS、安卓、iOS 都广泛支持的文件共享协议。设置共享名称例如MyMedia。设置访问权限可以设置为公开无需密码或需要用户名密码。家庭环境若信任所有设备可设公开否则建议设置密码。设置可读写或只读。保存设置。现在你在局域网的电脑上打开文件管理器输入\\你的主机IP(Windows) 或smb://你的主机IP(macOS)就能看到名为MyMedia的共享文件夹可以像操作本地磁盘一样存取文件。4.2 如何通过 App Store 部署应用以 Jellyfin 为例CasaOS 的“应用”本质上是预配置好的 Docker Compose 模板。这省去了你手动编写docker-compose.yml文件的麻烦。部署 Jellyfin 媒体服务器的完整流程打开 App Store在 CasaOS 左侧导航栏点击“应用”然后进入“应用商店”。搜索应用在搜索框输入 “Jellyfin”。你会看到官方维护的 Jellyfin 镜像。点击安装进入应用详情页点击“安装”。这时会弹出一个配置对话框这是最关键的一步。配置应用参数应用名称可以自定义如my-jellyfin。网络端口容器内部 Jellyfin 使用 8096 端口。你需要将其映射到主机的一个端口。例如主机端口填8096容器端口8096。这样你通过http://主机IP:8096就能访问 Jellyfin。文件路径映射Volume这是让 Jellyfin 访问你媒体文件的核心设置。配置路径容器内配置文件目录例如/config。将其映射到主机的一个目录如/mnt/mydata/appdata/jellyfin/config。这样 Jellyfin 的设置、元数据等会持久化保存在你的硬盘上不会随容器删除而丢失。媒体路径容器内媒体库目录例如/media。将其映射到你存放电影、音乐的硬盘目录如/mnt/mydata/media/movies和/mnt/mydata/media/music。你可以添加多个媒体路径映射。环境变量大部分应用有默认值Jellyfin 一般无需额外设置。对于某些应用可能需要设置时区TZAsia/Shanghai、用户 ID (PUID1000)、组 ID (PGID1000) 来保证文件权限正确。部署检查配置无误后点击“部署”。CasaOS 会开始从 Docker Hub如果配置了国内镜像则从镜像站拉取 Jellyfin 镜像并按照你的配置创建并启动容器。访问与初始化部署完成后在 CasaOS 的“应用”页面会出现my-jellyfin的卡片。点击卡片上的链接或直接访问http://主机IP:8096即可进入 Jellyfin 的 Web 界面进行语言、账号等初始化设置。关键经验路径映射是灵魂务必把容器内需要持久化的数据/config,/data等映射到主机硬盘上而不是容器内部。否则容器重置后数据就没了。先理解再配置不要盲目点击安装。花一分钟看看配置项想想端口会不会冲突路径对不对。尤其是PUID/PGID它们决定了容器内进程以哪个用户的权限运行如果和你存储文件的权限不匹配会导致应用无法读写文件。查看日志如果应用部署后无法访问第一时间点击应用卡片上的“日志”按钮查看容器启动日志里面通常有明确的错误信息。4.3 文件管理器的使用CasaOS 内置了一个简单的 Web 文件管理器。在左侧导航栏点击“文件”即可使用。你可以在这里浏览已添加的存储目录。上传、下载、删除、重命名文件和文件夹。在线预览图片、播放视频和音乐取决于浏览器支持。进行基本的文本编辑。注意这个文件管理器适合轻量级管理。对于大量文件的上传、下载或复杂操作建议还是通过前面设置的 SMB 共享在本地电脑上用专业的文件管理器如 Windows 资源管理器、macOS Finder进行操作速度更快、体验更好。5. 进阶配置、维护与常见问题排查系统跑起来后要让它稳定、好用还需要一些进阶配置和维护意识。5.1 配置 Docker 镜像加速器即使 CasaOS 安装用了国内源但后续在应用商店部署新应用时拉取 Docker 镜像可能仍然很慢。需要在 Docker 层面配置镜像加速器。编辑 Docker 守护进程配置文件sudo nano /etc/docker/daemon.json如果文件不存在或为空输入以下内容以阿里云镜像加速器为例需自行注册获取专属加速地址{ registry-mirrors: [https://your_mirror.mirror.aliyuncs.com] }常用的还有中科大、网易等镜像源。可以配置多个用逗号隔开。保存并退出编辑器。重启 Docker 服务使配置生效sudo systemctl restart docker验证是否生效sudo docker info | grep -A 1 Mirrors应该能看到你配置的镜像地址。5.2 系统更新与备份CasaOS 更新CasaOS 本身可以通过其 Web 界面的“设置” - “系统” - “更新”来检查并安装新版本。也可以在 SSH 中执行更新命令sudo casaos-upgrade。系统与安全更新不要忘记更新底层的 Linux 系统sudo apt update sudo apt upgrade -y。定期更新是保持系统安全的重要一环。数据备份CasaOS 管理的核心是你的数据媒体文件、文档和应用的配置数据。媒体文件这些是静态文件可以通过rsync等工具定期同步到另一块硬盘或另一台机器。应用配置它们位于你映射的宿主机目录中如/mnt/mydata/appdata/。备份这些目录即可。可以考虑使用tar或borg等工具进行压缩和增量备份。Docker 镜像与容器定义CasaOS 的应用配置实际上保存在其内部数据库中。虽然可以手动备份/var/lib/casaos目录但更可靠的方法是对于重要的自定义应用在部署时将其docker-compose.yml文件导出保存。CasaOS 未来版本可能会提供更完善的备份功能。5.3 常见问题与排查思路问题1安装脚本执行失败卡在下载或报错“Connection refused/timeout”。排查这是典型的网络问题。解决确认是否使用了国内源安装脚本。检查主机网络是否通畅ping -c 4 baidu.com。如果主机在国外或网络特殊可能需要配置代理。但需注意sudo环境下的命令可能不继承用户的环境变量需要显式配置curl -x http://proxy_ip:port -fsSL https://get.icewhale.io/casaos.sh | sudo bash。问题2能访问 CasaOS 界面但应用商店空白或加载慢。排查应用商店列表需要从 GitHub 等源获取。国内访问可能不稳定。解决等待一会儿有时是首次加载慢。在 CasaOS 设置中检查是否有“社区应用源”的配置可以尝试切换或添加备用源社区有时会提供镜像源地址。终极方案对于已知要安装的应用可以不通过应用商店而是使用“自定义安装”功能手动输入 Docker 镜像名和配置这需要你对 Docker Compose 有一定了解。问题3部署的应用无法访问或提示权限错误。排查这是最高频的问题。解决步骤查日志在 CasaOS 应用卡片点击“日志”看容器启动是否有报错。查端口确认主机端口是否被占用。sudo ss -tulnp | grep :端口号。如果被占用在应用配置里换一个主机端口。查路径权限这是最常见的原因。确保宿主机上你映射的目录如/mnt/mydata/appdata/jellyfin存在并且运行 Docker 容器的用户通常由PUID/PGID指定默认可能是1000:1000对该目录有读写权限。可以用ls -la /mnt/mydata查看目录所有者和权限必要时用sudo chown -R 1000:1000 /mnt/mydata/appdata修改。查防火墙确保主机防火墙放行了应用使用的端口。对于 Ubuntusudo ufw allow 8096/tcp。问题4SMB 共享在 Windows 上无法访问提示“无权限”。排查Windows 较新版本默认禁用 SMBv1并可能要求更安全的加密方式。解决在 CasaOS 的共享设置中尝试启用“支持 SMB2/3”的选项如果有。在 Windows 上打开“控制面板”-“程序”-“启用或关闭 Windows 功能”确保“SMB 1.0/CIFS 文件共享支持”下的客户端和服务器都取消勾选禁用 SMBv1使用更高版本。在 Windows 文件管理器的地址栏尝试用 IP 地址直接访问\\192.168.1.100。6. 总结CasaOS 的定位与长期使用建议经过以上步骤你应该已经成功搭建起一个基于 CasaOS 的个人云系统。最后我想分享几点长期使用的看法CasaOS 的强项在于快速部署和易用性它把 Docker 的强大能力用图形界面包装起来让不熟悉命令行的人也能轻松搭建服务。它的应用商店生态是其核心吸引力能不断发现和尝试新的自托管应用。但它并非全能。对于需要极致性能调优、复杂网络配置、高可用性集群、企业级权限管理的场景传统的专业 NAS 系统或手动搭建的 Docker Swarm/Kubernetes 集群仍是更合适的选择。CasaOS 更适合个人、家庭或小团队的非核心业务场景。给打算长期使用的朋友几点建议规划好存储数据盘最好用质量可靠的硬盘并考虑 RAID 1镜像等简单冗余方案来保护重要数据。系统盘和数据盘物理分离是好的实践。善用“自定义安装”当应用商店没有你需要的应用或者你想对某个应用进行更精细的配置时学习一下 Docker Compose 的基础知识使用“自定义安装”功能你将获得更大的灵活性。关注资源占用在仪表盘上留意 CPU、内存和磁盘 I/O。如果你部署了太多应用尤其是 Jellyfin 转码、PhotoPrism 图片分析这类重负载服务旧硬件可能会吃不消。定期更新与备份保持系统和应用更新并建立可靠的数据备份习惯。任何单点存储都有风险。总而言之CasaOS 是一个优秀的“家庭云操作系统”入门和便捷管理工具。用它来集中管理你的媒体库、同步文件、运行一些智能家居后端或开发测试环境会非常舒服。先从一两个核心应用如文件共享、媒体服务器用起熟悉了再慢慢扩展这才是最稳妥的路径。
 MDK-ARM 主流版本 + 发布时间汇总)
