CasaOS

IceWhaleTechApache-2.0活跃维护

把家用服务器变成私有云的个人云系统,基于 Docker 管理应用和文件,让自托管服务在树莓派等设备上开箱即用。

CasaOS - A simple, easy-to-use, elegant open-source Personal Cloud system.

v0.4.15发布于 2024-12-19 03:19 UTC37,615star +29 / 7 天2,224fork同步于 2026-11-10 11:20 UTC

怎么上手

由 README 提炼,执行前请确认
wget -qO- https://get.casaos.io | sudo bash
硬件要求按 README 说明

支持 amd64/x86-64、arm64、armv7 架构,官方称兼容 ZimaBoard、Intel NUC、树莓派及旧电脑;README 未说明具体内存或显存要求。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

面向家庭场景的开源个人云系统,用友好界面把旧电脑或开发板变成自托管服务器

把家用服务器变成私有云的个人云系统,基于 Docker 管理应用和文件,让自托管服务在树莓派等设备上开箱即用。

核心能力

  • 提供面向家庭场景的免代码友好 UI
  • 一键安装 Nextcloud、Jellyfin 等精选应用
  • 可安装 Docker 生态中的大量应用
  • 提供直观的磁盘与文件管理
  • 内置系统与应用资源、状态小组件

容易踩的坑

需先在 Debian 12、Ubuntu Server 20.04 或 Raspberry Pi OS 等受支持系统上全新安装;Alpine、OpenWrt、ArchLinux 仅社区支持且尚未充分测试;终端更新不能在 CasaOS UI 内的终端执行,需用 SSH 或直连终端。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.4.15
  1. v0.4.17-alpha1pre-release2025-04-17 · 2025-04-17 09:48 UTC
    查看更新说明

    Changelog

    • a6ff39e47d93ff2387f78c064cc930d64d53dfef Add initial RISC-V support (#2206)
    • 23eb739f017b7ce66a9c990abb5a556517b40557 Update README.md (#2185)
  2. v0.4.15最新正式版2024-12-19 · 2024-12-19 03:19 UTC

    Changelog

    • c26cf4dbecd7c33b5ace6952d42b9622d6237345 fix: cloud storage (#2096)
    • 6bbb0802aa8b55e8c133cfe04fb0a32ac5e9130b fix: problem while getting storage type (#2097)
    • ba285cb8bddb85fbd93060b3a8b944f35dd7a7ad fix: update user info retrieval and clean up unused code (#2101)
    • 63f01489a8e41adafae6b1bd0576b2cd242cb6d7 update version (#2098)
  3. v0.4.142024-12-10 · 2024-12-10 09:44 UTC
    查看更新说明

    Changelog

    • 7da0f0d49e6c9da44b717e23774198e5bfdd2cca Update README.md
    • 958a4833857b173ebcb7a98831e2f0017d6ccbfe Update constants.go (#2083)
    • 5ea588b813b3737951f5f7d13be5c83d6d5b8aa2 chore: fix problematic comments (#2030)
    • 16e97ec66ff1bb6afb57ed9d723339aff0ae397e fix: too much log (#2078)
  4. v0.4.132024-09-18 · 2024-09-18 07:54 UTC
    查看更新说明

    Changelog

    • 2adb7958964c484da20c0fe1b6fc79e6f8aab5a5 Update to 0.4.13 (#2004)
  5. v0.4.12pre-release2024-09-14 · 2024-09-14 03:42 UTC
    查看更新说明

    Changelog

    • e4bf67dad51fe30de10a19cd4ef0b4679ea68fa6 chore: bump casaos version (#1999)
    • bb0d9ac25ce747c0ff9595773d5737d48771aefb feat: add sync OpenAPI workflows (#1995)
    • e8f9d3aaf5d8f1dae932185965bf02595b6b6a88 fix: fix GitHub Action not work (#1996)

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    CasaOS - Your Personal Cloud

    Why do you need Personal Cloud?

    In 2020, the team noticed three important trends:

    • The cost of computing power and storage was decreasing fast.
    • A part of cloud computing was moving towards edge computing.
    • The issue of consumer data asset ownership and attribution had been ignored.

    Based on these trends, the team proposed a thought experiment internally: what if personal clouds were available under $100 in next five years? This personal cloud would provide a low-cost data collaboration solution as a personal data center, storing and managing data for creators and small organizations. A distributed collaborative computing network can be formed by personal servers located around the world. It could also control and connect all smart devices, providing cross-ecosystem local intelligent services.

    Furthermore, the personal cloud could combine personal data to train personalized AI assistants. The idea is that this technology would be an effective way to solve the issue of consumer data asset ownership and , as well as provide a more affordable and efficient computing solution for individuals and small organizations.

    If you think what we are doing is valuable. Please give us a star ⭐ and fork it 🤞!

    Features

    • Friendly UI designed for home scenarios
      • No code, no forms, intuitive, design for humanity
    • Multiple hardware and base system support
      • ZimaBoard, NUC, RPi, old computers, whatever is available.
    • Selected apps in the app store, one-click installation
      • Nextcloud, HomeAssistant, AdGuard, Jellyfin, *arr and more!
    • Easily install numerous Docker apps
      • Over 100,000 apps from the Docker ecosystem can be easily installed
    • Elegant drive and file management
      • What you see is what you get. No technical background required.
    • Well-designed system/app widgets
      • What you care about, at a glance. Resource usage, app status, and more!

    Getting Started

    CasaOS fully supports ZimaBoard, Intel NUC, and Raspberry Pi. Also, more computers and development boards and fully compatible with Ubuntu, Debian, Raspberry Pi OS, and CentOS with one-liner installation.

    Hardware Compatibility

    • amd64 / x86-64
    • arm64
    • armv7

    System Compatibility

    Official Support

    • Debian 12 (✅ Tested, Recommended)
    • Ubuntu Server 20.04 (✅ Tested)
    • Raspberry Pi OS (✅ Tested)

    Community Support

    • Elementary 6.1 (✅ Tested)
    • Armbian 22.04 (✅ Tested)
    • Alpine (🚧 Not Fully Tested Yet)
    • OpenWrt (🚧 Not Fully Tested Yet)
    • ArchLinux (🚧 Not Fully Tested Yet)

    Quick Setup CasaOS

    Freshly install a system from the list above and run this command:

    wget -qO- https://get.casaos.io | sudo bash
    

    or

    curl -fsSL https://get.casaos.io | sudo bash
    

    Update CasaOS

    CasaOS can be updated from the User Interface (UI), via Settings ... Update.

    Alternatively it can be updated from a terminal session. To update from a terminal session, it must be done either from a secure shell (ssh) session to the device or from a directly attached terminal and keyboard to the device running CasaOS, this cannot be done from the terminal via the CasaOS User Interface (UI). To update to the latest release of CasaOS from a terminal session run this command:

    wget -qO- https://get.casaos.io/update | sudo bash
    

    or

    curl -fsSL https://get.casaos.io/update | sudo bash
    

    To determine version of CasaOS from a terminal session run this command:

    casaos -v
    

    Uninstall CasaOS

    v0.3.3 or newer

    casaos-uninstall
    

    Before v0.3.3

    curl -fsSL https://get.icewhale.io/casaos-uninstall.sh | sudo bash
    

    Community

    The word Casa comes from the Spanish word for "home". Project CasaOS originated as a pre-installed system for the crowdfunded product ZimaBoard on Kickstarter.

    After looking at many systems and software on the market, the team found no server system designed for home scenarios, sadly true.

    So, we set out to build this open-source project to develop CasaOS with our own hands, everyone in the community, and you.

    We believe that through community-driven collaborative innovation and open communication with global developers, we can reshape the digital home experience like never before.

    A warm welcome for you to get help or share great ideas in the Discord!

    Discord Card

    Contributing

    CasaOS is a community-driven open source project and the people involved are CasaOS users. That means CasaOS will always need contributions from community members just like you!

    Credits

    Many thanks to everyone who has helped CasaOS so far!

    Everyone's contribution is greatly appreciated. (Emoji Key)

    This project follows the all-contributors specification. Contributions of any kind are welcome!

    Changelog

    Detailed changes for each release are documented in the release notes.