在单台服务器上搭建个人云操作系统，通过 tailnet 提供桌面、隔离工作空间和自托管应用。

方案简介

AgentVerse OS 是一个面向开发者及其 AI Agent 的「个人云操作系统」。整个系统跑在单台服务器上，桌面、工作空间和 Agent 都常驻服务器；用户通过浏览器在任何设备（笔记本、平板、手机）上访问同一个窗口化的桌面，所有状态保持一致并在断点处继续工作。它把 vibe coding 流程做成跨平台：同一个桌面、同一些工作空间、同一些 Agent，在三种设备上体验一致。

项目定位是「一个人的私人服务器」，而不是多租户云平台：当前还没有用户账号与权限体系，整个项目跑在一台测试机上，处于 alpha 阶段。它的目标用户是希望拥有自己的云端开发与自托管环境、又不想向公网暴露服务的开发者：Ubuntu 上一条命令安装，剩下的配置、登录、应用安装全部在浏览器中完成。

亮点与能力

• 项目与隔离工作空间：每个项目拥有自己的网络、唯一的入口（gate），运行在独立的 Incus 容器中，容器内嵌套 Docker；工作空间内预装 VS Code（浏览器版）、终端以及 Claude Code、Codex 等 Agent，使用项目自身的订阅登录。
• 944 款应用商店：将 Runtipi、Coolify、Umbrel 三家目录合并为一个统一目录，每款应用带有来源徽标；提供引导式安装、凭据直达卡片、日志查看、数据目录权限自动修复、应用间链接（如 n8n → LiteLLM）以及按应用的快照与回滚。
• 以能力（Capability）代替地址：项目声明需要的 storage.s3、llm、notify 等能力，由核心把项目 gate 连到对应 provider 网络并下发环境变量；更换 S3 后端（如把 Garage 换成 MinIO）不需要改项目代码。
• 纯浏览器体验：首次启动向导通过链接或二维码加入 Tailscale，校验 DNS 与证书，并创建第一个项目；系统和应用更新都通过 Updates 窗口完成，新版本启动失败时自动回滚。
• 备份：默认关闭。基于 ZFS 定时快照，再用 restic 从快照中取出；任意应用可在两次点击内回滚。
• 桌面化 UI：窗口、任务栏、开始菜单、小部件（监控、时钟、新闻、天气、项目）、基于应用数据与工作空间主目录的「Files」、密码与访问管理、主题与壁纸、开机画面、离线遮罩、屏保；界面支持英语、俄语、乌克兰语、西班牙语。
• 已上架的两款助手：Hermes Agent（带 Web 面板）与 Pipecat Voice（浏览器内语音助手，支持本地语音识别与合成）。

前置要求

硬件与系统前置要求：

• 一台干净的 Ubuntu 22.04+ 主机（已在 26.04 上测试）。
• 至少 8 GB 内存。
• 推荐一块独立的磁盘给 ZFS。
• 一个 Tailscale 账号。

安装命令（从发布包安装，不需要本地编译）：

curl -LO https://github.com/agentverse-os/AgentVerse-OS/releases/download/v0.2.0/agentverse-os-0.2.0-x86_64.tar.gz
mkdir agentverse-os && tar xzf agentverse-os-0.2.0-x86_64.tar.gz -C agentverse-os && cd agentverse-os
sudo DISKS="/dev/disk/by-id/<disk for ZFS>" bootstrap/install.sh

也可以从源码构建：

git clone https://github.com/<owner>/agentverse-os && cd agentverse-os
cd desktop && npm install && npm run build && cd ..        # Desktop → cloudd/static
cd cloudd && cargo build --release && cd ..                # core with the Desktop embedded
sudo DISKS="/dev/disk/by-id/<disk for ZFS>" bootstrap/install.sh

实施步骤

安装器按以下顺序逐步推进，整个流程在浏览器中完成收尾：

1. 准备系统

在一台干净的 Ubuntu 22.04+（测试于 26.04）主机上执行，准备一块 /dev/disk/by-id/ 指向的磁盘用于 ZFS。

2. 拉取并启动安装

下载 release 包或 clone 仓库，然后运行 bootstrap/install.sh：

sudo DISKS="/dev/disk/by-id/<disk for ZFS>" bootstrap/install.sh

3. 主机检查与 ZFS

安装器首先做主机检查，再创建 ZFS 数据集，作为后续快照与 restic 备份的载体。

4. 部署 Docker 与 Incus

安装 Docker 与 Incus，每个项目后续会运行在独立的 Incus 容器中，容器内嵌套 Docker。

5. 加入 Tailscale

安装器给出一个链接与二维码，等待你在 Tailscale 上授权节点，然后校验 MagicDNS 与 HTTPS 证书是否就绪。

6. 安装 Coder

部署工作空间控制平面 Coder，后续所有项目工作空间由其编排。

7. 安装 Komodo

部署 App Runtime Komodo，用于把商店应用以 compose 栈形式跑起来。

8. edge 与核心

部署 edge Caddy（:443 Desktop / :8444 Coder / :8450+ 应用）以及 cloudd 核心，核心内嵌 Desktop 前端静态文件。

9. 拉取目录与模板

加载合并后的 944 款应用目录与项目模板。

10. 完成浏览器内首次启动

安装器给出 tailnet 地址，例如 https://..ts.net/。在浏览器打开后，首次启动向导继续完成首个项目的创建，配置即告完成。

11. 可选：从 checkout 安装预构建包

可以通过 PACKAGE=agentverse-os--.tar.gz（本地文件或 https URL）让安装器从包安装，而不是用本地构建产物；包由 scripts/release.sh 生成。

使用与配置要点

安装完成后，使用方式围绕 tailnet 与浏览器展开：

• 日常入口：在任意设备的浏览器打开 https://..ts.net/，首次启动向导会在浏览器内完成剩余配置并创建第一个项目。
• 跨设备一致：同一桌面、工作空间、Agent 在笔记本、平板、手机上以 PWA 形态呈现，工作空间与 Agent 始终在服务器上运行，离开设备后再回来，状态继续。
• 创建项目：每个项目创建后获得独立网络、gate、独立 Incus 容器（内含 Docker）、VS Code 与 Agent；可通过项目卡片 stop/start 实例、按需调整资源。
• 应用商店：从 Store 浏览 944 款自托管应用，每张卡片显示来源徽标（Runtipi / Coolify / Umbrel），提供引导式安装、凭据查看、日志查看、数据目录权限自动修复、应用间链接，以及按应用的快照与回滚。
• 能力接线：在项目中声明需要的能力（如 storage.s3、llm、notify），由核心把项目 gate 接到 provider 网络并下发环境变量；更换 S3 后端无需改项目。
• 更新：系统与应用更新统一通过 Updates 窗口完成，新版本启动失败会自动回滚。
• 备份：默认关闭；启用后由 ZFS 定时快照 + restic 仓库承担，可在两次点击内回滚单个应用。
• 网络与证书：整个系统仅在 tailnet 内暴露，无需在设备上安装私有根 CA。

注意事项与常见问题

• 项目阶段：当前处于 alpha，整个项目跑在一台测试机上，作为「一个人的私人服务器」使用，还没有用户账号与权限体系。
• 使用规模：明确为单人单服务器场景，不面向多用户协作或多租户部署。
• 网络暴露：所有访问都通过 Tailscale（tailnet），不向公网开放；这同时意味着断网或 Tailscale 不可用时无法访问桌面。
• 硬件底线：8 GB 内存与一块 ZFS 磁盘是推荐最低配置；ZFS 池与快照是其备份机制的根基。
• 能力与路由：核心只有 7 个实体（project、workspace、gate、app、capability、grant、route）与 4 个 contract，其余皆为第三方成熟软件；扩展时优先以「能力」接线而非硬编码地址。
• 语言：界面支持英语、俄语、乌克兰语、西班牙语，可跟随浏览器或一次性为所有设备设定。
• 语音控制：系统本身的语音控制目前在路线图上；当前可装的 Pipecat Voice 仅作为一款浏览器内语音助手应用上架。

优缺点

• ✓ 面向 tailnet 暴露，不向公网开放
• ✓ 工作空间可跨设备保持与继续
• ✕ 处于 alpha 阶段，目前为单人单服务
• ✕ ZFS 与 8GB 内存对硬件有最低要求

出处

本方案挖掘自开源项目 agentverse-os/AgentVerse-OS，方案内容与实施命令均来自其 README 原文。