系统要求

适用于:StablEdge 团队版私有化部署 · 具体要求以交付时的部署包说明为准

本页列出部署团队版服务端之前需要准备的环境。部署包正在整理中,下面的要求会随部署包一起最终确定;表中写着「以交付时的部署包说明为准」的项目,目前还没有定论,请在部署前通过联系我们确认。

服务器

项目要求
操作系统Linux 服务器。支持的发行版和版本以交付时的部署包说明为准。
部署规模全部服务端组件可以运行在一台服务器上,也可以按企业已有的基础设施分开部署。
CPU以交付时的部署包说明为准。
内存整机配置以交付时的部署包说明为准。桌面 Agent 后端每个工作进程建议预留约 0.5 GiB 内存,默认 4 个进程合计约 2 GiB,随进程数线性增加。
磁盘以交付时的部署包说明为准。需要为数据库、上传文件和备份预留空间,用量取决于企业的成员数和文件规模;文件存在服务器本地磁盘时,还要为这部分文件预留空间。
服务器配置和成员规模、并发对话量相关。部署前可以通过联系我们,按企业的实际情况获取建议配置。

依赖组件

组件要求用途
Docker 与 Docker Compose版本以交付时的部署包说明为准运行一体化部署包
PostgreSQL13 或以上,推荐 16 及以上;需要预先在数据库中安装 pgvector 扩展 0.8.4 或以上各服务端组件的业务数据;pgvector 用于知识库的向量检索
Redis7 或以上,需开启 AOF 持久化用户与组织服务的限流与会话;模型服务的图片任务队列
文件存储服务器本地磁盘(默认),或阿里云 OSS上传文件、云存储、生成的图片、桌面端安装包

使用一体化部署包时,PostgreSQL 和 Redis 可以随部署包一起运行,也可以改用企业已有的实例。改用已有实例时,请确认版本、pgvector 扩展、AOF 持久化和连接数满足要求。

数据库连接数

桌面 Agent 后端在默认配置下峰值约占用 100 个数据库连接。与其他服务共用同一个数据库实例时,建议把最大连接数设为不少于 300。桌面 Agent 后端每增加一个工作进程,约需增加 26 个连接,调整工作进程数前请先核算连接数。

文件存储

默认使用服务器本地磁盘,也可以改用阿里云 OSS。分发桌面端安装包需要对象存储:桌面端的更新安装包存放在对象存储中,只使用本地磁盘时无法向桌面端分发安装包。

不开启对象存储时,平台不保存生成的图片,只返回模型供应商提供的结果(临时链接或图片数据),有效期以供应商为准,请及时保存;需要长期保存生成的图片,请开启对象存储。

模型与知识库

模型服务需要企业录入所选模型供应商的密钥,支持 OpenAI、Anthropic,以及兼容 OpenAI 或 Anthropic 协议的服务。

已验证的接入示例:DeepSeek、Kimi(Moonshot)、智谱、通义千问、MiniMax、火山方舟(豆包)、小米 MiMo。

知识库需要配置一个向量化(embedding)模型。

账号与登录方式以交付时的部署包说明为准。

网络与域名

  • 域名:准备一个供员工访问的域名,桌面端通过这个域名连接服务端。所有接口都在同一个域名下,由反向代理按路径分流,不需要为每个服务单独准备域名。
  • 入站:员工电脑需要能通过 HTTPS 访问这个域名。服务之间的内部接口和模型服务不对外开放,只在服务端内部网络中互相访问。
  • 出站:服务器需要能访问所选的模型供应商与向量化模型接口;选用阿里云 OSS 时,还需要能访问对应的 OSS 服务。

TLS 证书

反向代理只通过 HTTPS 对外提供服务,需要为上面的域名准备有效的 TLS 证书,证书和私钥由企业提供并自行保管。证书的格式要求和更换方式以交付时的部署包说明为准。

请使用员工电脑信任的证书。证书不受信任时,桌面端无法连接服务端。

桌面端

  • 桌面端连接企业自建服务端的功能将在后续版本提供,版本要求以交付时的部署包说明为准。
  • 桌面端支持的操作系统以官网下载区为准。
  • 由企业自建服务端统一下发桌面端更新(版本检查与强制更新)的功能,随桌面端接入在后续版本提供;届时安装包存放在对象存储中。

部署前检查清单

  1. 一台满足要求的 Linux 服务器,已安装 Docker 与 Docker Compose。
  2. 员工访问用的域名,以及该域名的 TLS 证书。
  3. 员工电脑能通过 HTTPS 访问该域名;服务器能访问所选的模型供应商与向量化模型接口。
  4. 所选的模型供应商与向量化模型接口的密钥。
  5. 决定文件存储方式:服务器本地磁盘,或阿里云 OSS;需要分发桌面端安装包时选用对象存储。
  6. 决定是否使用企业已有的 PostgreSQL、Redis 实例,并核算数据库连接数。

准备好后,按部署方式与获取支持中的流程进行。

本页目录