离线部署
本页说明隔离网络部署所需的材料与验收范围。离线运行能力与在线一键安装是不同条件:不能在无公网环境中直接复用会下载外部资源的安装命令。
CSGHub CE 和 EE 均提供公开安装包,支持自助安装;需要协助时可 联系技术支持。离线环境应先在可联网环境获取所选版本的安装材料及依赖,再传入内网安装。
选择安装方式
- Docker:按 Docker 安装指南 选择 CE/EE 对应的配置与镜像版本。
- Kubernetes:按 Kubernetes 安装指南 获取 Chart,准备匹配的配置与镜像。
- 需要协助:向技术支持提供产品版本、部署方式、硬件架构与网络条件,以便确认所需材料和安装步骤。
公开安装包与具体功能授权 是不同事项;安装 EE 后如需导入许可证,请参阅 许可证导入。下面的清单用于离线准备与验收;执行命令时按所选版本的安装指南配置内部资源地址。
需要准备的材料
| 材料 | 核对内容 |
|---|---|
| 软件与组件 | 固定 CSGHub 版本、Chart/配置、组件镜像、CPU 架构与镜像摘要 |
| 本地仓库 | 内网镜像仓库及凭据;如安装流程需要,准备本地 Chart/软件包源 |
| 算力依赖 | 操作系统、容器运行时、Kubernetes、驱动、设备插件与存储组件 |
| 模型与数据 | 所需权重、配置、分词器、数据集及对应版本;避免运行时再下载 |
| 应用运行依赖 | Space 构建依赖、Python/系统软件包、微调和评测镜像;必要时准备内部镜像源 |
| 基础服务 | 内部 DNS、证书、身份认证、对象存储与时间同步 |
| 备份与恢复 | 配置、数据库、仓库与大文件存储、业务持久卷的备份及恢复位置 |
明确联网边界
本地模型推理、资产管理和训练在依赖准备齐全后可在内 网运行。远端同步、第三方商业模型 API、外部 MCP 工具、云端内容检测、应用代码内的外部请求仍需相应连接。根据使用场景配置内部替代服务或关闭这些连接,并实际验证。
验收与更新
在无公网条件下完成登录、仓库上传下载、模型部署调用、任务执行和重启验证;检查日志是否仍尝试访问外部资源。按 部署后验收 保存结果。
升级前重新准备目标版本的镜像、依赖与迁移步骤,不使用未固定版本的在线更新命令。先验证备份可恢复,再安排升级。