Rancher 多集群管理核心是先部署 Rancher Server（Local 集群），再纳管下游集群。支持导入现有集群或通过 UI 一键创建 RKE2/K3s 等新集群，提供统一权限、跨集群应用部署、监控告警及安全生命周期管理。
安装配置 Rancher 实现多集群容器管理，核心在于先部署一个稳定可靠的 Rancher Server（即管理集群），再将各类下游 Kubernetes 集群（包括 RKE2、K3s、EKS、AKS 或自建 kubeadm 集群）统一纳管。整个过程不依赖特定云厂商，也不强制要求你重装所有集群——已有集群可直接导入，新集群可通过 Rancher UI 一键创建。
一、部署 Rancher Server 管理平面
Rancher Server 本身必须运行在一个 Kubernetes 集群上（称为 Local 集群）。生产环境推荐使用 RKE2 或 K3s 部署该管理集群，兼顾安全与轻量；测试环境可用单节点 Docker 快速启动。
- 单节点 Docker 方式（适合验证和开发）：
docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher:latest
访问https://<服务器IP>初始化管理员账户，注意需提前配置好 TLS（可启用 Let’s Encrypt 或挂载证书） - 高可用方式（生产推荐）：
用 RKE2 在三台节点上部署 HA 集群 → 创建cattle-system命名空间 → 通过 Helm 安装 Rancher：helm repo add rancher-latest https://releases.rancher.com/server-charts/latesthelm install rancher rancher-latest/rancher --namespace cattle-system --set hostname=rancher.example.com
二、准备并接入下游集群
下游集群无需修改原有架构，只需确保网络可达、kubeconfig 可用，并满足最低版本要求（K8s ≥ 1.20，RKE2 ≥ v1.21+）。Rancher 支持两类接入方式：
-
导入现有集群：适用于已运行的 RKE2、kubeadm、EKS 等集群。
在 Rancher UI 中选择「添加集群」→「导入现有集群」→ 输入名称 → 复制并执行生成的kubectl apply -f命令（该命令会部署cattle-cluster-agent和相关 RBAC） -
通过 UI 创建新集群：适合快速搭建标准化集群。
选择「RKE2」或「K3s」模板 → 配置节点角色（etcd/control plane/worker）、OS 类型、SSH 凭据 → Rancher 自动下发脚本并完成部署
三、统一配置与跨集群操作
集群接入后，Rancher 提供图形化界面实现集中治理，关键能力落地如下：
- 权限统一管控：在「全局 > 用户与认证」中对接 LDAP/AD，再为不同团队分配「项目级 RBAC」，例如开发组只能操作 dev 命名空间，运维组可管理全部集群节点
- 应用跨集群部署：进入「Apps & Marketplace」，选择 Helm Chart（如 Prometheus、Nginx Ingress），勾选多个目标集群 → 一次发布，自动同步到各集群对应命名空间
- 监控与告警联动：启用集群级别监控（Prometheus + Grafana），仪表盘默认聚合 CPU/内存/Pod 状态；设置告警策略时可指定通知渠道（钉钉/企业微信/Webhook）并关联多个集群
四、安全与生命周期管理
Rancher 内置机制大幅降低合规成本，无需逐个集群重复配置：
- 集群升级：在 UI 中点击集群 → 「升级」→ 选择新版 RKE2 版本号，支持灰度升级（先升 control plane，再滚动升级 worker）
- 证书管理：RKE2 集群自动轮换证书；Rancher Server 自动更新 ingress TLS 证书（配合 cert-manager 或内置 ACME）
- 策略即代码：通过「Cluster Management > RKE2 Config」导出 YAML 模板，结合 GitOps 工具（如 Flux）实现集群配置版本化与审计追溯
