KubeSphere 多机部署 CubeStudio
本目录说明如何用 KubeSphere（基于 KubeKey 安装）搭建一套多节点 Kubernetes 集群，并在其上部署 CubeStudio。适合需要多机、希望有 KubeSphere 可视化管理界面的生产/准生产环境。
整体流程分三步：
- 主机环境准备：每台机器做基线初始化（主机名、时间同步、关闭 firewalld/selinux/swap、内核参数、ipvs）和系统优化。
- 安装 KubeSphere 与 K8s 集群：下载 KubeKey（kk），生成多节点配置文件，一键创建集群并部署 KubeSphere 控制台。
- 部署 CubeStudio：准备共享存储（NFS / JuiceFS），打节点标签，处理 istio 网关与 kube-proxy 转发模式，最后用
start.sh部署平台。
部署前的机器规格、操作系统、k8s 版本等要求见 部署总览与前置要求。
子文档目录（TOC）
| 文档 | 内容 |
|---|---|
| 01-主机环境与系统优化.md | 步骤 1：每台机器环境初始化（主机名、主机名解析、时间同步、禁用 firewalld/iptables/selinux/swap、内核参数、ipvs 模块）；以及系统优化（内核引导参数、overlay2、sysctl、文件句柄限制） |
| 02-安装KubeSphere与K8s集群.md | 步骤 2-3：下载 KubeKey（kk）、创建并编辑多节点配置文件（hosts / roleGroups / controlPlaneEndpoint / addons）、创建集群、验证安装、kubectl 自动补全 |
| 03-部署cube-studio.md | 步骤 4：下载源码、复制 kubeconfig、打节点标签、istio 网关 nodeport、kube-proxy IPVS→iptables、NFS / JuiceFS 分布式存储、最后 start.sh 部署平台 |
与单机部署的区别
- 单机/k3s 部署只需一台机器，KubeSphere 多机部署需要多台并由 KubeKey 统一纳管。
- KubeSphere 会自带 Prometheus 等组件，所以部署 CubeStudio 用的是专门的脚本
install/kubernetes/start-with-kubesphere.sh（跳过 Prometheus operator 那一整套，复用 KubeSphere 自带 Prometheus；详见 03 文档）。 - 单机/k3s 路径见 k3s 单机部署 或 单机 k8s 部署。
本目录中 KubeSphere / KubeKey 的版本号、外部命令均来自原始部署笔记，请在自己的环境再验证；CubeStudio 的部署命令与参数以源码（
install/kubernetes/）为准，本目录仅供导航与上手。