一条命令接入你的 AI Agent：

claude mcp add --transport http --scope user casos http://localhost:20080/mcp --header "Authorization: Bearer <token>"

打开右上角账号菜单 → AI Agents 创建 token。那个页面也有 Cursor、Codex 和其他 MCP 客户端的现成配置。

和其他项目的区别。 k3s、minikube 只给你一个集群；CasOS 在此之上还带界面、应用 商店、私有 AI 和 Agent 接入，并且能在 Windows 上原生运行。Coolify、CasaOS 在 Docker 上提供一键应用；CasOS 提供同样的体验，但底层是真正的 Kubernetes，通过 SSH 添加机器 就能扩展。

快速开始

三步，大约五分钟。无需任何 Kubernetes 基础。

1. 安装

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/casosorg/casos/master/scripts/install.sh | bash

Windows（PowerShell）

irm https://raw.githubusercontent.com/casosorg/casos/master/scripts/install.ps1 | iex

安装脚本会下载最新版本，解压出可执行文件并加入到你的用户 PATH 中。在 Windows 上， 当前 PowerShell 会话可以立即使用；在 Linux 和 macOS 上，请打开一个新的 shell（或执行 安装脚本打印出的 source 命令）。不想运行脚本？从 发布页面下载对应系统的压缩包并解压 即可——里面只有一个可执行文件，别无其他。

2. 启动

casos

在 Windows 上你也可以直接双击 casos.exe——它会启动服务并自动为你打开浏览器。

3. 打开界面

访问 http://localhost:20080，你已经以 admin 身份登录。

⚠️ 请先修改密码。 全新安装带有内置账号 admin / 123 并会自动登录，这意味着 任何能访问该端口的人都是管理员。点击右上角的账号菜单 → 我的账号 → 设置一个真 正的密码。一旦密码不再是 123，自动登录就会停止。

4. 安装第一个应用

打开应用商店，安装任何你喜欢的应用。整个流程就是这样——CasOS 会拉取 Chart、完成 调度，并把运行中的应用展示给你。

仪表盘上有一个首次运行清单，会跟踪上述步骤，四项全部完成后自动消失。每一步的状态 都从服务端读取，所以刷新页面或换一个浏览器登录后依然准确。

CasOS 自动完成的工作

你不需要添加节点、安装 CNI 或配置存储。启动时 CasOS 会：

• 把运行它的这台机器变成工作节点。 在 Linux 上就是主机本身；在 Windows 上使用你的 WSL 发行版——如果没有，它会为你安装 WSL。可以在机器页面查看进度。
• 启动 Ingress 控制器和服务负载均衡器，让应用获得可访问的地址。
• 把所有数据存放在数据目录下的 SQLite 中——无需搭建数据库。

出问题了怎么办

升级与卸载

重新执行安装命令即可升级。卸载：

curl -fsSL https://raw.githubusercontent.com/casosorg/casos/master/scripts/install.sh | bash -s -- --uninstall

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/casosorg/casos/master/scripts/install.ps1))) -Uninstall

你的数据目录不会被删除。它保存着 SQLite 数据库、控制平面的 TLS 材料，以及用于解密 已保存的 SSH 凭据的密钥，因此删除它是一个独立且需要慎重决定的动作——卸载程序会打印出 该目录的路径和对应的删除命令。

curl -fsSL https://raw.githubusercontent.com/casosorg/casos/master/scripts/install.sh | CASOS_VERSION=v1.32.0 INSTALL_DIR="$HOME/.local/bin" bash

$env:CASOS_VERSION = 'v1.32.0'
irm https://raw.githubusercontent.com/casosorg/casos/master/scripts/install.ps1 | iex

Remove-Item Env:\CASOS_VERSION

功能特性

• 内嵌 Kubernetes —— API Server、Controller Manager 和 Scheduler 都在同一个二进制 文件里。不需要外部集群，也不需要 kubeadm。
• 零配置工作节点 —— 启动 CasOS 的这台机器会自行加入集群；更多机器可以在机器页面 通过 SSH 添加。
• 应用商店 —— 在界面上安装和管理 Helm Release。
• 完整的资源管理 —— Deployment、StatefulSet、DaemonSet、Job、CronJob、Pod、Service、 Ingress、ConfigMap、Secret、PVC、StorageClass、HPA、配额、命名空间和 RBAC。
• 可观测性 —— 仪表盘、集群拓扑、监控、日志搜索，以及浏览器中的 Pod 终端。
• 安全 —— 基于 Casbin 的准入与授权策略，以及 Trivy 镜像扫描。
• 开箱即用的登录 —— 内置 admin 账号，也可选接入 Casdoor 单点登录。
• 多语言界面（i18n）。

配置

大多数人永远用不到这一节：CasOS 使用默认配置即可运行，而全新安装最可能需要修改的设置 就是 HTTP 端口。

配置文件位于可执行文件旁边的 conf/app.conf：

httpport      = 20080      ; Web 界面和 REST API
apiserverPort = 20443      ; 内嵌的 Kubernetes API Server
dataDir       = ./data     ; 数据库、TLS 材料、凭据密钥

driverName    = sqlite     ; 默认值；同时支持 "mysql"
casdoorEndpoint =          ; 留空 = 使用内置 admin 账号
autoEnrollLocalNode = true ; 启动时把本机变成工作节点

没有 conf/app.conf 时启动的二进制会把数据存放到用户级数据目录： ~/.local/share/casos、~/Library/Application Support/CasOS 或 %LOCALAPPDATA%\CasOS。CasOS 会在启动时以 casos data directory: <path> 的形式打印它解析出的目录。

登录方式

casdoorEndpoint 决定你如何登录，除此之外无需任何配置：

要使用 Casdoor，请在首次启动前填好全部五项 Casdoor 配置。每一项都可以通过同名的环境 变量读取，因此 clientSecret 不必写入磁盘：

casdoorEndpoint=https://your-casdoor-instance clientId=... clientSecret=... casdoorOrganization=... casdoorApplication=... casos

开发

前置条件：Go 1.26+、Node.js 20+ 和 Yarn 1.x。所有前端命令都在 web/ 目录下执行，包管理器 是 yarn——锁文件为 web/yarn.lock。

git clone https://github.com/casosorg/casos.git
cd casos

后端 —— 在 20080 端口提供 API 和界面：

go run main.go

前端 —— 开发服务器运行在 8002 端口，把 API 代理到 localhost:20080 （可用 BACKEND_URL 覆盖）：

cd web
yarn install    # 仅首次需要
yarn start

测试与代码检查：

cd web
yarn lint          # 带 --fix 的 ESLint
yarn lint:ci       # 同样的检查但不带 --fix，与 CI 一致
yarn test:unit     # 单元测试
yarn ui:test       # Playwright 端到端测试；会自行启动后端和开发服务器

组件约定，以及 Playwright 测试所依赖的选择器钩子，见 web/FRONTEND.md。

构建发布用二进制

后端会从磁盘读取 web/build/，所以开发时只重新构建前端就够了。要生成发布版所提供的那个 自包含的单文件，请先构建前端，再用 -tags embed 编译：

cd web && yarn build && cd ..
CGO_ENABLED=0 go build -trimpath -tags embed -o casos .

每个发布版本都会为 x86_64 架构的 Linux、macOS 和 Windows 提供该二进制，打包为 .tar.gz（Linux、macOS）或 .zip（Windows），其中只包含这一个可执行文件。

项目结构

casos/
├── main.go          # 入口
├── conf/app.conf    # 后端配置
├── controllers/     # HTTP 控制器（Beego 路由）
├── object/          # 业务逻辑与数据模型
├── routers/         # 路由配置与过滤器
├── server/          # 内嵌的 Kubernetes 控制平面
├── deploy/          # 节点部署与本地节点引导
├── store/           # Helm 与应用商店逻辑
├── proxy/           # kube-proxy 相关逻辑
├── i18n/            # 后端翻译
└── web/             # React 前端
    └── src/
        ├── pages/       # 每个页面一个文件
        ├── components/  # shadcn/ui 组件与共享控件
        ├── backend/     # API 客户端辅助方法
        ├── hooks/ lib/ locales/
        └── routes.jsx

许可证

Apache 2.0