TUEO 私有化部署手册（国产化 / 信创）

面向交付工程师与运维团队的部署手册。TUEO 私有化是主线：每客户一套独立、单站点、隔离；国产化优先、离线 / 气隙默认、一键装；数据不出企业，全程可审计、可回滚。

1. 国产化与信创适配

TUEO 全面适配国产化软硬件环境，支持在信创整机、国产 CPU 架构、国产 GPU 加速卡与信创操作系统上部署运行，满足党政、公安、政务、能源、金融等关键行业对安全可控的合规要求：

• 国产 CPU 架构：支持主流国产化 CPU（x86 与 ARM 生态）作为控制面与计算节点；
• 国产 GPU 加速卡：支持国产 GPU 完成模型推理与向量检索加速，可在完全内网环境运行；
• 信创操作系统：适配主流国产化 Linux 发行版，兼容其软件源与内核基线；
• 信创验证：已在公安、政务等关键行业完成部署验证，满足等保与分级保护要求。

平台同时兼容通用 x86 服务器与标准 Linux 发行版，交付形态可裁剪：纯国产化栈（信创整机 + 国产 GPU + 信创 OS）或 通用栈 均可一键部署。

2. 部署形态与架构

2.1 三种交付形态

2.2 分层架构

L3 产品与中间件    identity · cohort · studio · capabilities · executor
                   + PG / Redis / MinIO / 知识库 / IM / 模型网关
L2 运维平台        TUEO Console（配置中心 · 日志 · 状态墙 · 部署编排 · 备份 · 审计）
L1 底座            Harbor 内网镜像仓 · 数据库高可用 · 证书 · 网关
L0 集群底座        k3s HA · 内网缓存层 · 镜像代理
算力层             多模型算力服务器 —— 独立算力节点，统一部署与纳管模型
L-1 OS 基线        国产 / 通用操作系统 · 内核基线 · 软件源加速

多模型算力服务器是部署架构中的独立算力节点，专门用于部署模型：

• 统一承载多模型：大语言模型推理、向量嵌入、视觉 / 语音模型，可在同一算力节点按需部署与调度；
• 国产 / 通用加速卡：支持国产 GPU 与通用加速卡，模型推理与向量检索完全在内网完成；
• 经平台统一纳管：模型服务由运维平台登记与部署，模型密钥不出服务端，调用经内网模型网关统一路由；
• 可独立扩展：按业务规模单独扩容算力节点，不影响控制面与业务节点。

关键点：底座（数据库 / 缓存 / 容器底座 / 对象存储 / 模型算力）也是由运维平台统一管理的被管对象，不是客户另找团队维护的第三方基础设施。平台连自己都是被管对象（自升级只换镜像、创世清单永为单一真值）。

3. 部署阶段（目录即顺序）

部署采用可重放脚本 + 站点清单，从裸机装成生产环境，无需手敲 SSH：

部署后，00 预检 的脚本兼作验收体检，可随时复跑。

4. 站点清单（声明式配置）

每个客户站点一份 site/<name>.yaml，脚本参数化读取、零硬编码：

• 站点：名称、域名后缀、时区；
• 网络：Pod / 服务网段、节点子网、网关、DNS、公网入口、带外管理网；
• 源：离线 bundle 路径或镜像 URL（气隙站点走离线 bundle）；
• 接入：跳板机、SSH 凭据引用（明文不入库）；
• 节点：主机名、内网 IP、角色（控制面 / 计算 / 多模型算力）、硬件规格与硬约束；
• 算力：加速卡类型与数量（国产 / 通用皆可），以及要部署的模型清单与资源预留。

5. 离线与气隙部署

气隙（完全断网）是默认能力，不是选配：

• 离线镜像交付：在联网环境构建镜像打包 → 站内装载进内网镜像仓 → 集群拉取，节点零 docker；
• 离线 bundle：把容器底座、镜像、系统包打成离线 bundle，气隙站点一次性带入；
• 内网缓存：镜像代理 + 软件源缓存，慢公网（如仅 0.5MB/s）下每份依赖只过一次慢线；
• 离线更新：.tueoupdate 签名更新包验签后导入，目录段转能力平台、镜像段装进内网仓，未签包一律拒绝；
• 离线授权：签名 License 零联网激活，软节点锁防复制到多部署。

6. 运维手册

部署完成后，所有运维在 TUEO Console 一个界面完成：

平台自升级：push 代码自动构建 → 镜像晋级 → 换镜像 → 探活收敛；升级只动镜像标签，不重渲染创世清单（数据卷 / 主密钥 / 网关全保留）。

7. 安全与合规

• 数据不出企业：全部组件内网部署，模型可走客户自管网关或本地模型，密钥不出客户网络；
• 多租户物理隔离：数据库行级安全 + 服务层显式租户过滤双防御；
• 审计留痕：密码学哈希链审计，篡改可检测；敏感操作二次确认 + 审批流；
• 纵深防御：OIDC 单点登录、角色收敛、凭据金库加密、断网沙箱、内容安全门；
• 信创合规：全站私有化部署，满足等保、分级保护与关键行业合规要求。

8. 交付清单

部署有疑问，或需要信创环境联合调优，请联系 TUEO 交付团队。