Developer Docs

文档首页

开发文档 · 运行应用

端云一体与部署选型

Desktop、托管 Cloud 与私有化部署的运行边界、当前拓扑和选型检查项。

状态:Experimental(Runtime / Management) — Desktop 与单节点 Server 路径已有实现;托管 Cloud、私有化规格、扩展 Profile 和多副本拓扑按具体版本与交付环境验证,不构成统一 Runtime / Management 兼容承诺。

Fellow 的 Desktop、Web 与 Server 使用同一套 Thread、Run、SSE、Skills 和集成语义,但存储、认证、沙箱和运营方式由 Deployment Profile 与环境配置决定。部署形态相近不等于底层拓扑完全相同。

了解商业部署选择与服务方式:Fellow Deployment

当前运行拓扑

Desktop 在本机启动 Gateway。Console 是独立服务,通过受保护的 API 管理 Server 实例,不应画成 Gateway 容器内部组件。

部署选择

模式当前边界适合
Desktop 本机模式SQLite、本机配置、OS 沙箱,可免登录使用自备模型 Key单人验证、开发和受控样例测试
托管 CloudFellow 负责基础设施与更新,组织配置由服务端管理希望减少平台运维的团队
私有化 ServerGateway 与数据在客户控制的网络和基础设施中运行有数据驻留、网络隔离或自主管理要求的组织

具体可用规格、身份集成和服务责任以部署版本与合同为准,不应仅根据模式名称推断。

默认镜像与扩展 Profile

当前仓库的默认 Cloud Docker 镜像采用单节点路径:SQLite、内存 Stream Bridge 和本地 sandbox mode。仓库同时提供 PostgreSQL、Redis 和 Docker sandbox 的 Profile 配置结构,但这些配置不代表默认 Compose 已形成完整的多副本生产拓扑。

生产设计需要单独确认:

  • 数据库备份、迁移与恢复;
  • 多实例事件流和粘性连接策略;
  • Sandbox 后端及其平台限制;
  • 对象或文件存储的持久化方式;
  • Console 与 Gateway 的网络和令牌边界;
  • 模型、Connector 与 MCP 的出站网络策略。

端云一致与不一致

保持一致:

  • Thread、Run 与 SSE 客户端协议;
  • Agent Runtime、Skills 和工作区成果语义;
  • Connectors、MCP、SDK 与 Channels 的主要接入模型。

需要迁移或重新确认:

  • 本机 config.yaml 与服务端 Console 管理配置;
  • SQLite 数据与 Server 数据库;
  • 用户认证、组织和 Integration App;
  • 文件路径、凭证引用、网络与 Sandbox 策略。

因此,从 Desktop 进入 Server 生产不是复制目录即可完成,而是按目标环境重新建立数据、身份和运行边界。

选型检查项

问题影响
数据必须保存在哪里?托管区域、客户网络或本机
谁负责升级、备份和故障恢复?托管 Cloud 或客户运维
是否需要 OIDC、组织用户和接入应用?认证与 Console 配置
需要连接哪些内网系统?网络、Connector、MCP 与凭证设计
哪些操作需要人工确认?Scope、Consent 与工具策略
预计并发和事件流规模是多少?单节点或扩展拓扑验证

推荐迁移顺序

  1. Desktop 用样例完成一个可验收任务。
  2. 固定 Skill、模型、输入和回归样例。
  3. 在目标 Server 环境重建最小配置,只接入一个只读数据源。
  4. 验证身份、权限、数据保存、事件流与失败恢复。
  5. 通过 Console 建立运营责任,再逐步扩大用户和写权限。

完整试点门槛见 企业智能化升级

商业许可

生产 Server、私有化和对外托管的许可要求见 概述 · 商业许可,具体部署包与服务范围请 联系 Fellow

下一步