私有化部署的验收范围应覆盖一次完整业务请求：用户登录、上传文件、生成索引、检索回答、调用工具，以及备份恢复。容器成功启动只能证明启动链路通过。技术负责人还需要为数据边界、容量、升级和故障恢复指定责任人。
六项就绪条件
| 条件 | 上线前应准备的材料 | 通过标准 |
|---|---|---|
| 部署版本与架构 | 主服务、插件、模型网关、沙箱与数据库的版本清单 | 按所选版本的部署文件检查镜像架构、依赖与配置格式 |
| 数据与网络边界 | 文档、向量、聊天记录、模型请求和对象存储的流向图 | 每条外部调用有明确目的、鉴权与网络规则 |
| 持久化与恢复 | 数据卷、数据库和对象存储的备份清单 | 在隔离环境完成恢复，并通过文档检索与文件访问复测 |
| 模型与业务链路 | 聊天、embedding、重排和工具调用的测试集 | 使用实际账号与实际业务入口跑通正向和失败场景 |
| 容量与可观测性 | 峰值请求、批量导入、存储增长与告警阈值 | 在预期负载下记录延迟、错误率、队列积压与资源余量 |
| 升级与运行责任 | 升级窗口、负责人、回滚触发条件与值班联系表 | 演练版本升级，并确认旧数据与业务入口的恢复路径 |
从部署文件建立配置基线
选择与目标版本对应的官方部署文件，固定镜像标签并保存实际配置。逐项检查主服务与附属服务是否属于兼容组合。模型网关、插件和 Agent 沙箱的升级说明可能各有变化，应分别阅读。
数据库、缓存与对象存储使用外部服务时，核对连接串、TLS、账号权限和访问网络。容器之间的服务地址、宿主机可达地址与浏览器可达地址属于不同访问路径。文件上传后要分别测试服务端处理、用户下载和预览，避免只验证其中一条路径。
部署文件包含的向量数据库方案会随版本变化。CPU 架构、数据库种类和服务最低版本应以选定部署文件及其镜像清单为准。把这些选择写入部署记录，可以避免将某次历史故障误用为通用兼容性结论。
保留沙箱隔离条件
启用代码执行或 Agent 沙箱时，检查宿主机内核、容器权限、网络与文件访问策略。出现 seccomp 加载错误后，应先对照该沙箱版本的说明复现环境，再选择兼容的宿主机或升级方案。
Docker seccomp profile 为系统调用提供过滤。部署时保留所选沙箱要求的隔离条件，并按官方说明评估兼容性调整。沙箱健康检查通过后，还应补充超时、受限文件访问和受限网络访问场景。
用业务请求验收
- 用普通成员账号登录应用，检查团队、知识库与应用权限。
- 上传一组真实文档，等待训练任务完成，核对分段、索引与错误记录。
- 通过正式入口提问，核对答案、引用和流式响应；加入无答案问题检查边界。
- 调用实际需要的工具，分别测试正常返回、超时和鉴权失败。
- 在隔离环境恢复数据库与文件，确认应用绑定、文档检索和下载仍能工作。
- 在计划峰值下重复上述路径，记录延迟分位数、失败比例与队列恢复时间。
确定上线决定
为每项失败指定负责人、修复期限与复测入口。数据恢复、模型鉴权、权限隔离等关键链路通过后，再根据业务允许的剩余风险决定流量规模。将最初的容量估算与上线后的实测值对照，及时调整资源和告警阈值。