版本

SoyaOS 是一份二进制。所谓版本，就是部署形态——节点角色跑在哪里、由谁运维、它们怎么联邦。变的只有一行 CLI 参数。

soyaos start --edition solo      # 或 cluster | cloud | hybrid | ent-cloud | ent-private

矩阵

所有版本都跑同一份 SoyaPack 格式，对外暴露同一份 OpenAI 兼容 API。唯一变化是「你运维」与「我们运维」的边界画在哪里——在 solo 里这两端折叠到笔记本上的一个进程。

决策树

按行往下匹配，第一个命中的就选；新手默认 solo。

各版本细读

solo — 所有东西都在进程里

Planet、Moon、Comet 折叠成机器上的单一进程。无注册中心、无鉴权、无网络面。感受 SoyaOS 最快的方式，也是我们测试最深的形态。

• 状态存储：~/.local/share/soyaos/ 下的 SQLite（Windows 是 %LOCALAPPDATA%）。
• 鉴权：无。进程只监听 127.0.0.1。
• 上限：只受硬件限制。我们在一台 2018 MacBook Air 上跑过。

cluster — 一个你跑的 Planet + 你扩的 Comet

创业期工程团队的默认形态。一台小 VPS 跑 Planet；Comet 工作节点用 soyaos join 接入。SoyaPack 清单仓库放在任意 S3 兼容存储。

• 状态存储：Postgres（推荐），小团队也可用 SQLite。
• 鉴权：初期共享组织 token，长大后切 OIDC。
• 网络：Comet 只需对 Planet 出网 HTTPS；不需要可入站访问。

cloud — 托管 Planet + 托管 Comet

我们运维一切，你只持有 API Key。「拿到一个能跑的 Agent endpoint」最快的路径。随时切到自己的 BYOK 模型 Key，从此只为我们实际调度的算力付费、不再为推理付费。

• Region：alpha → beta 期间待定。
• 数据：传输和存储都加密；我们不在你的数据上训练。

hybrid — 托管 Planet，你的 Comet

编排在云端，工作负载留在你的边界内。适合数据出不去、又不想自己运维控制面的场景。Comet 只需对我们 Planet 出网 HTTPS。

• 何时用：HIPAA / PCI /「客户数据不出 VPC」这种约束。
• 何时别用：你还想把审计日志也放在自己机器上——那就直接选 ent-private。

ent-cloud — 独占多租户 SaaS

独占 region、SSO/SAML、SOC 2 合规、签名审计日志导出。和 solo 同一个内核——区别只在运维。按年付席次 + MSA 合同。

ent-private — 本地化或物理隔离

同一份二进制部署进封闭网络。通过签名离线升级包更新。在出网默认拒绝的银行、实验室环境里验证过。签名 Key 在客户手里——我们没有后门。

切换版本

没有「另装一份」这种事——soyaos 是同一份二进制。切换只是改一个配置参数。版本间迁移设计为非破坏性：SoyaPack、能力白名单、Scope 事件都能 round-trip。

solo → cluster 的实际切换长这样：

# 在你的 VPS 上：
soyaos start --edition cluster --bind 0.0.0.0:8443 --state postgres://...

# 在你之前跑 solo 的笔记本上：
soyaos pack push hello                                # 把 SoyaPack 发布到新 Planet
soyaos join --moon https://moon.example.com --token <invite>

跨版本不变的东西

• SoyaPack 格式（soyapack.yaml v0）。
• OpenAI 兼容 surface 在 /v1/chat/completions。
• 能力白名单——同一种形状，同一份强制。
• Scope 事件 schema——你的 dashboard、告警、审计日志都期望同一份 JSON。
• CLI 命令——pack、run、serve、auth、join。只是参数不同。

矩阵背后的 Planet / Moon / Comet 模型，见架构。

在 GitHub 上编辑本页