> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 要求与依赖

> 运行一个 Cyberun 部署需要你提供哪些 —— 外部依赖、支持的操作系统/运行时版本、预期规模范围。

Cyberun 部署在你提供的一组外部依赖(数据库、对象存储、缓存、消息总线、可选的 SMTP)之上运行 Cyberun 的二进制文件。本页列出该部署要正常工作所需的内容。

具体的生产容量数字 —— 核数、内存、IOPS、单网关吞吐量、单集群代理数 —— 正在作为公开部署指南的一部分编写中。请通过 [sales@cyberun.cloud](mailto:sales@cyberun.cloud) 联系我们,获取当前针对你预期规模的参考数字。

## 控制面依赖

云侧组件(API 服务器、代理网关、OIDC 颁发者、许可证校验器)需要:

| 依赖     | 角色                    | 需提供的接口        |
| ------ | --------------------- | ------------- |
| 关系型数据库 | 持久状态(用户、团队、凭证、工作流、任务) | 任何标准 SQL 数据库  |
| 对象存储   | 工作流输入、任务产物、模型上传       | 任何兼容 S3 的 API |
| 内存存储   | 令牌、会话状态、网关连接表         | 任何内存键值存储      |
| 消息总线   | 任务生命周期事件、网关到服务端的扇出    | 任何事件 / 消息总线   |
| SMTP   | 账号验证、密码重置、邀请(可选)      | 任何兼容 SMTP 的中继 |

以上是开发环境默认配置。生产部署可挑选兼容的托管服务或自托管对等物 —— 控制面对话的是标准接口,因此替换十分直接。具体的厂商兼容性说明正在编写中。

## 代理主机要求

运行 Cyberun 代理的机器需要:

* **CPU/RAM**:为所选运行时(ComfyUI 或 Nerfstudio)预留足够余量,再加上代理进程自身固定的少量开销。
* **GPU**:与你要运行的运行时相匹配。代理可在每个受支持的操作系统上运行;每个运行时各自决定其 GPU 与操作系统要求(参见 [Platform → 代理](/zh/platform/agents))。一台带当前 CUDA 驱动的 NVIDIA 主机可覆盖所有运行时。
* **磁盘**:首次运行时用于团队模型缓存与节点包的存储空间;具体大小取决于工作流。活跃负载请预留 100 GB 以上。
* **网络**:从主机出站到网关 URL 的 HTTPS。无需任何入站暴露。还需向对象存储端点出站,以上传产物。
* **操作系统**:Linux(amd64 或 arm64)、macOS 或 Windows。各平台安装脚本见 [Platform → 代理](/zh/platform/agents)。

正式的兼容性矩阵(CUDA 版本 × 运行时版本 × 操作系统)正在编写中。

## 网络拓扑

| 方向                         | 用途              |
| -------------------------- | --------------- |
| 浏览器 → API(HTTPS)           | 控制台、REST 运行时调用。 |
| AI 客户端 → MCP 端点(HTTPS,可流式) | 外部 AI 客户端驱动平台。  |
| 代理主机 → 网关(HTTPS,升级为 WSS)   | 仅出站。代理主机无需入站端口。 |
| 服务端 / 网关 → 对象存储            | 产物上传与签名 URL 颁发。 |
| 服务端 → SMTP(可选)             | 账号验证、邀请、密码重置。   |

平台有意将代理保持在纯出站路径上,以便它们能够干净地安装在企业防火墙与 NAT 之后。入站暴露仅限于控制面(API、网关、OIDC 颁发者)。

## 身份

Cyberun 自带一个自托管的 OIDC 颁发者,负责签发平台中使用的令牌。外部集成:

* **上游 OAuth 登录**(目前为 Google;更多提供商开发中),用于终端用户登录 —— 由 `oauth` 功能门控。
* **OIDC 颁发者**,外部应用可与之联邦 —— 由 `oidc_provider` 门控。

对于不支持 OIDC 的企业 IdP,在 Cyberun 前面接入一个 OIDC 代理;原生上游集成正在编写中。

完整图景见[身份](/zh/platform/identity)。

## 规模指引

小型到中型部署的早期参考形态:

* **一个** API 服务器,一个网关,一个许可证服务器。进程级别均为无状态(状态存于上述依赖中)。
* **三个或以上** 代理主机,用以无队列地承接常见工作流需求。
* **数据库 + 对象存储** 容量按团队的任务量调整。

多站点部署在同一信任网中加入更多集群 —— 参见[部署模式](/zh/platform/deployment-patterns)。

更高规模(数百用户、每日数千任务等)的生产容量规划与一份显式的横向扩展指南正在编写中。在它上线之前,合作伙伴部署会与 Cyberun 协同进行手工容量评估;[联系](mailto:sales@cyberun.cloud)我们并附上你的规模目标,我们将分享当前的参考数字。

## 另见

* [架构](/zh/platform/architecture) —— 每个组件是什么以及它们与谁对话。
* [部署模式](/zh/platform/deployment-patterns) —— 拓扑形态。
* [代理](/zh/platform/agents) —— 各 OS 上的代理安装流程。
* [功能目录](/zh/platform/feature-catalog) —— 平台二进制中哪些是可选的、哪些是始终启用的。