跳到主要内容

离线部署

本页说明隔离网络部署所需的材料与验收范围。离线运行能力与在线一键安装是不同条件:不能在无公网环境中直接复用会下载外部资源的安装命令。

CSGHub CE 和 EE 均提供公开安装包,支持自助安装;需要协助时可 联系技术支持。离线环境应先在可联网环境获取所选版本的安装材料及依赖,再传入内网安装。

选择安装方式​

  • Docker:按 Docker 安装指南 选择 CE/EE 对应的配置与镜像版本。
  • Kubernetes:按 Kubernetes 安装指南 获取 Chart,准备匹配的配置与镜像。
  • 需要协助:向技术支持提供产品版本、部署方式、硬件架构与网络条件,以便确认所需材料和安装步骤。

公开安装包与具体功能授权是不同事项;安装 EE 后如需导入许可证,请参阅 许可证导入。下面的清单用于离线准备与验收;执行命令时按所选版本的安装指南配置内部资源地址。

需要准备的材料​

材料核对内容
软件与组件固定 CSGHub 版本、Chart/配置、组件镜像、CPU 架构与镜像摘要
本地仓库内网镜像仓库及凭据;如安装流程需要,准备本地 Chart/软件包源
算力依赖操作系统、容器运行时、Kubernetes、驱动、设备插件与存储组件
模型与数据所需权重、配置、分词器、数据集及对应版本;避免运行时再下载
应用运行依赖Space 构建依赖、Python/系统软件包、微调和评测镜像;必要时准备内部镜像源
基础服务内部 DNS、证书、身份认证、对象存储与时间同步
备份与恢复配置、数据库、仓库与大文件存储、业务持久卷的备份及恢复位置

网络与硬件需求见 网络条件 和 硬件条件。

明确联网边界​

本地模型推理、资产管理和训练在依赖准备齐全后可在内网运行。远端同步、第三方商业模型 API、外部 MCP 工具、云端内容检测、应用代码内的外部请求仍需相应连接。根据使用场景配置内部替代服务或关闭这些连接,并实际验证。

验收与更新​

在无公网条件下完成登录、仓库上传下载、模型部署调用、任务执行和重启验证;检查日志是否仍尝试访问外部资源。按 部署后验收 保存结果。

升级前重新准备目标版本的镜像、依赖与迁移步骤,不使用未固定版本的在线更新命令。先验证备份可恢复,再安排升级。