部署安装总览
本段落覆盖 CubeStudio 平台的各种部署方式，以及部署前需要准备的机器、存储、GPU、集群等基础环境。
完整文档索引请看
00-索引/，本页只做部署相关的导航与“选哪种部署方式”的决策指引。
先读：部署前置要求
无论选择哪种部署方式，都建议先通读前置要求，确认机器规格、操作系统、k8s 版本、存储与网络是否满足。
- 部署总览与前置要求 —— 基础环境依赖（docker / kubernetes 版本、机器配置、共享存储、GPU/IB 网络、操作系统），以及平台部署完成后的形态。
- 平台由哪些组件构成、各组件在哪个命名空间、用的哪个版本：见 01-架构原理/基础组件介绍.md。
- 平台整体架构与设计原理：见 01-架构原理/项目简介.md。
怎么选部署方式
| 场景 | 推荐方式 | 文档 |
|---|---|---|
| 个人本地体验 / 二次开发调试，仅需 web 端功能，不需要真正调度 k8s 任务 | docker-compose 本地部署 | 单机部署-docker-compose |
| 单台 / 少量机器上跑完整平台（含真实 k8s 任务调度、notebook、推理服务） | 单机 k8s 部署（rancher 起 k8s + start.sh 部署平台） | 单机 k8s 部署 |
| 已有 k8s 集群，直接部署平台 | 已有 k8s 部署（start.sh） | 单机 k8s 部署 · 对于已有 k8s 的同学 |
| 隔离内网 / 离线环境 | 离线部署（基于已有 k8s 部署流程 + 离线镜像） | 单机 k8s 部署 · 隔离内网 |
说明：docker-compose 方式只起前端、后端、mysql、redis 四个容器，适合开发调试与功能体验；它不会在本机起一个 k8s 集群，发起真实 pipeline / notebook / 推理任务仍需连接一个 k8s 集群（见 docker-compose 文档中的“本地连接 k8s 集群”小节）。
部署方式子目录
相关运维文档（部署后会用到）
- 配置文件管理：04-运维管理/配置文件管理.md
- 私有镜像仓库 Harbor：04-运维管理/私有镜像仓库Harbor.md
- 分布式存储目录：04-运维管理/分布式存储目录.md
- 平台 HTTPS 配置：04-运维管理/平台HTTPS配置.md
- 元数据库（MySQL / PG / 达梦 / Kingbase）：04-运维管理/元数据库配置.md
- 端口使用情况：04-运维管理/端口使用情况.md
本页为导航页，具体部署命令与参数以源码（
install/、install/docker/、install/kubernetes/）为准，仅供导航。