本页说明团队版私有化部署目前的交付方式，以及部署的整体流程。每一步的具体操作随部署包提供，这里只说明各步骤做什么。
交付方式
目前团队版的私有化部署由 StablEdge 团队协助完成：我们按企业的环境给出部署方案，并安排专人部署。支持部署在云服务器、物理机、软硬一体机和离线环境中。
一体化部署包即将提供。部署包基于 Docker Compose，在一台服务器上即可拉起全部服务端组件，并附带完整的操作说明。部署包发布后，本栏目会补充详细的部署步骤。
部署流程
无论由 StablEdge 团队协助部署，还是之后使用一体化部署包自行部署，流程都分为以下六步。
1. 准备环境
按系统要求准备服务器、Docker、域名、TLS 证书，以及向量化模型 API 和模型供应商账号，并确认网络连通：员工电脑能访问域名，服务器能访问所需的外部服务。这一步还要决定文件存储方式，以及是否使用企业已有的 PostgreSQL、Redis。
2. 获取部署包
部署包包含各服务端组件、配置文件示例和操作说明，由 StablEdge 团队提供。服务器不能访问外网时，请提前通过联系我们告知，以便按离线环境准备部署包。
3. 配置域名与证书
把域名解析到服务器，并把 TLS 证书和私钥交给反向代理使用。反向代理是对外的唯一入口：它在同一个域名下按路径把请求转发给用户与组织服务或桌面 Agent 后端，服务之间的内部接口和模型服务不对外开放。各组件的关系见架构总览。
4. 初始化
首次部署时完成以下几件事：
- 生成服务间密钥：各服务互相调用所需的密钥由初始化流程自动生成，不需要手动填写；再次执行时不会覆盖已有的值。
- 初始化数据库：为各服务建库，并依次执行各服务的数据库结构初始化。
- 创建企业：使用部署包提供的方式创建首个账号并创建企业，该账号即企业管理员，再由管理员创建部门和成员。账号与登录方式以交付时的部署包说明为准。
- 录入模型：部署后通过管理后台录入模型供应商的接口密钥和可用模型。
- 检查服务状态：确认各服务的健康检查通过，日志里没有报错，再完成一次登录、对话和生图的冒烟验证。
5. 桌面端接入
桌面端连接企业自建服务端的功能将在后续版本提供，具体接入方式以交付时的部署包说明为准。
6. 升级与备份
- 升级：新版本以新的部署包提供。升级前先备份。升级（尤其包含数据库迁移时）需先执行迁移，再同时重启模型服务的 API 服务和后台任务服务，然后各做一次健康检查；最后再完成一次冒烟验证。
- 备份：定期备份数据库和上传文件，初始化时生成的密钥也要妥善备份。
- 回滚：升级出现问题时，先停止新版本，恢复到上一版本的部署包和配置；涉及数据库变更时，用升级前的备份恢复。
配置文件和初始化时生成的密钥只保存在企业自己的服务器上，请限制访问权限，不要提交到代码仓库，也不要通过聊天工具传输。
获取支持
需要部署团队版时，请通过联系我们与 StablEdge 团队沟通部署方案。