Zentrix Gateway 文档
用户手册

26. 上线检查、稳定运行与管理交接

完整版章节。内容按 2026.10 主线代码核对;具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

运维范围:本章的平台级检查由私有部署的平台管理员执行;SaaS 方式下由服务运营方执行,租户管理员只检查本租户范围内的项目。受许可模块控制的页面(“护栏”需要“模型护栏”,“流量规则”需要“动态路由”,“操作审计”需要“全链路审计”,用量与成本需要“FinOps”)只在许可包含相应模块时出现。

上线检查以真实账号和真实入口完成,重点确认成员能完成工作、无权限人员被正确拒绝、异常能够定位和恢复。

26.1 完成上线前检查

平台部署检查(平台管理员):

  1. 安装器输出的装后验收全部通过;在“部署配置 → 最近一次验收”中结果为“已通过”,没有阻断项。
  2. 已保存 root 初始密码,并在首次登录时修改密码、绑定两步验证;平台管理人员已使用个人平台账号。
  3. “系统更新”中当前版本、部署方式和已启用能力符合交付清单。
  4. “系统运行监控”中控制面、数据面和依赖均无“异常”项;“网关 → 概览”中中心节点及远端节点在线,“入口池可服务”。
  5. “网关 → 入口与证书”中业务访问地址、管理访问地址和入口证书正确,“入口自检”全部就绪;外部客户端可以通过业务入口访问,防火墙或安全组已放行业务入口与管理入口端口。
  6. “部署配置”中运维通知渠道已配置;“数据依赖”中各依赖的部署方式与管理方符合方案。
  7. 已执行一次备份,记录备份标识,并将归档转存到安装主机以外;已明确恢复责任人和维护窗口。

租户使用检查(租户管理员):先逐项完成第 25 章的「上线检查清单」,再补充以下检查:

  1. “授权许可”中授权用户数、到期时间和高级模块符合合同。
  2. 需要单点登录时,“SSO 配置”中的身份源已启用并完成一次登录。
  3. 使用试点成员账号核对首页、能力列表和可用范围,并分别验证模型服务、MCP 服务、API 服务、外部智能体和 API 密钥的正常调用。
  4. 需要系统邮件时,“SMTP 配置”已通过测试邮件验证。
  5. 记录未完成项、影响范围、临时处理方式和负责人,再决定是否扩大使用范围。

26.2 查看平台负载并处理容量问题

  1. 选定同一时间范围,在“概览”中查看请求量、错误率和响应耗时;平台管理员同时在“系统运行监控”中查看各组成部分的状态与实例资源占用。
  2. 按模型服务、API 密钥、外部智能体或网关节点缩小影响范围。网关节点的“5 分钟请求数”“5 分钟错误率”和“回传积压”可用于判断单个节点的负载。
  3. 打开代表性调用,区分上游响应慢、工具执行慢、护栏处理耗时或重复调用。上游不可达时,在“出口网络”检查平台访问公网的延迟与丢包。
  4. 检查模型服务的“可用范围与配额”、流量规则的“全局限额”、租户的“每月 Token 上限”和上游供应商状态。
  5. 整机资源紧张导致请求被拒绝时,在“网关 → 过载保护”核对处理器与内存的高、低水位,并在“网关 → 节点”的节点详情查看“本机负载”与“过载保护”状态。
  6. 一次只调整一类限制,并记录原值和恢复值。
  7. 使用正常业务请求验证恢复,再继续观察同一时间窗口的错误和耗时变化。

“最多在线人数”与模型请求限制属于不同层级。登录受限时检查“账号与会话安全 → 安全策略”中的在线人数上限与会话设置;模型请求被拒绝时检查配额、限额和过载阈值。

26.3 配置和检查平台安全控制

  1. 核对“SSO 配置”中的身份源,以及“安全策略”中的空闲超时、绝对超时、登录方式、强制两步验证和密码策略。
  2. 平台管理员核对“管理面访问网段”是否只允许运维网段访问管理控制台,以及“SSRF 出站防护”的放行范围。
  3. 核对模型服务、MCP 服务、技能和外部智能体的可用范围,以及路由策略中针对 MCP 工具的规则。
  4. 核对“护栏”中的敏感数据规则、词库与问答,以及流量规则中内容检测的检测项和命中处置。
  5. 核对外部连接使用的凭据、HTTPS、允许访问的出口目标和审批方式;外部智能体需经“批准”后才能配置调用方访问。
  6. 使用一个允许样例和一个拒绝样例验证每项重要策略。
  7. 在护栏命中记录、“操作审计”和调用记录中确认命中结果、执行结果和操作人员可以关联。

安全检查不能只使用管理员账号。至少使用普通成员、业务管理人员和平台管理员三类账号核对界面可见性与直接访问结果。

26.4 完成平台管理交接

  1. 为接任人员分配与职责相符的管理角色:租户内通过“角色管理”,平台级通过“平台账号”授予“平台管理员”,并使用其账号核对可见菜单。
  2. 确认组织、模型、MCP、外部智能体、护栏、告警、审计、备份恢复、升级和网关节点的负责人。
  3. 轮换由原管理员保管的 API 密钥、上游账号密钥、入口证书私钥、DNS 服务商凭据和连接凭据。备份文件含主密钥,应与密钥服务的密钥目录 /etc/zenova/secret-service/keys 的主机级备份一起按密钥材料移交保管责任。
  4. 原管理员掌握 root 密码时,在安装主机执行 sudo zenova root-password set 重置。该命令打印新的初始密码,清除 root 的两步验证并让 root 的全部会话失效。
  5. 由接任人员完成一次模型或能力变更、一次异常定位和一次备份。
  6. 核对支持联系人、维护窗口、运维通知渠道和紧急处理方式。
  7. 确认接管完成后,通过“移除”角色成员或“撤销平台管理员”收回原管理员不再需要的权限,并核对变更记录。

26.5 提交支持请求

提交支持请求时,按第 27 章准备信息并遵守其中的保密要求。


上一章:25. 分阶段上线 · 下一章:27. 联系支持所需信息

On this page