本页列出部署团队版服务端之前需要准备的环境。部署包正在整理中,下面的要求会随部署包一起最终确定;表中写着「以交付时的部署包说明为准」的项目,目前还没有定论,请在部署前通过联系我们确认。
服务器
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux 服务器。支持的发行版和版本以交付时的部署包说明为准。 |
| 部署规模 | 全部服务端组件可以运行在一台服务器上,也可以按企业已有的基础设施分开部署。 |
| CPU | 以交付时的部署包说明为准。 |
| 内存 | 整机配置以交付时的部署包说明为准。桌面 Agent 后端每个工作进程建议预留约 0.5 GiB 内存,默认 4 个进程合计约 2 GiB,随进程数线性增加。 |
| 磁盘 | 以交付时的部署包说明为准。需要为数据库、上传文件和备份预留空间,用量取决于企业的成员数和文件规模;文件存在服务器本地磁盘时,还要为这部分文件预留空间。 |
依赖组件
| 组件 | 要求 | 用途 |
|---|---|---|
| Docker 与 Docker Compose | 版本以交付时的部署包说明为准 | 运行一体化部署包 |
| PostgreSQL | 13 或以上,推荐 16 及以上;需要预先在数据库中安装 pgvector 扩展 0.8.4 或以上 | 各服务端组件的业务数据;pgvector 用于知识库的向量检索 |
| Redis | 7 或以上,需开启 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 证书,证书和私钥由企业提供并自行保管。证书的格式要求和更换方式以交付时的部署包说明为准。
桌面端
- 桌面端连接企业自建服务端的功能将在后续版本提供,版本要求以交付时的部署包说明为准。
- 桌面端支持的操作系统以官网下载区为准。
- 由企业自建服务端统一下发桌面端更新(版本检查与强制更新)的功能,随桌面端接入在后续版本提供;届时安装包存放在对象存储中。
部署前检查清单
- 一台满足要求的 Linux 服务器,已安装 Docker 与 Docker Compose。
- 员工访问用的域名,以及该域名的 TLS 证书。
- 员工电脑能通过 HTTPS 访问该域名;服务器能访问所选的模型供应商与向量化模型接口。
- 所选的模型供应商与向量化模型接口的密钥。
- 决定文件存储方式:服务器本地磁盘,或阿里云 OSS;需要分发桌面端安装包时选用对象存储。
- 决定是否使用企业已有的 PostgreSQL、Redis 实例,并核算数据库连接数。
准备好后,按部署方式与获取支持中的流程进行。