主题
Rancher Prime + K3s v1.35.4+k3s1 零基础入门与运维手册
最后更新: 2026-08-31 集群版本: K3s v1.35.4+k3s1 (Kubernetes v1.35.4) 集群规模: 3 Master (Server) + 1 Worker (Agent) 管理平面: Rancher Prime (Web UI 多集群统一管理) 适用读者: 第一次接触 Rancher Prime / K3s 的同学，按顺序读完即可上手
文件清单
| 文件 | 内容 | 建议阅读顺序 |
|---|---|---|
| 01-零基础入门与集群原理 | 概念扫盲、3 Master + 1 Worker 架构原理、从零搭建集群并导入 Rancher Prime | ① 先读 |
| 02-Rancher-Prime-UI使用指南 | UI 布局、全局/集群视图详解、8 个实操演练、RBAC 与技巧 | ② 再读 |
| 03-日常运维手册 | 巡检、备份恢复、升级、证书、故障排查、应急预案 | ③ 常备手边 |
| 04-网络通信与节点故障影响分析 | 节点内/跨节点/etcd 通信原理，任意节点宕机的影响矩阵与自愈时间线 | ④ 进阶理解 |
集群环境总览
拓扑
┌──────────────────────────────────────────────────┐
│ Rancher Prime (管理平面) │
│ 已有 K8s 集群上, 通过 cattle-agent │
│ 纳管本集群 (导入模式) │
└──────────────────┬───────────────────────────────┘
│ wss (agent 反向连接)
┌───────────────────────────────┼───────────────────────────────┐
│ ▼ │
│ API VIP: 192.168.122.43:6443 (建议, keepalived/自研脚本) │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ .38 Master-1 │ │ .39 Master-2 │ │ .40 Master-3 │ │
│ │ szb122038 │ │ szb122039 │ │ szb122040 │ │
│ │ apiserver │ │ apiserver │ │ apiserver │ │
│ │ etcd(内置) │◄─┤ etcd(内置) │◄─┤ etcd(内置) │ │
│ │ scheduler │ │ scheduler │ │ scheduler │ │
│ │ ctrl-manager │ │ ctrl-manager │ │ ctrl-manager │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ └──────────────────┼──────────────────┘ │
│ │ 6443 │
│ ┌─────────▼──────┐ │
│ │ .41 Worker-1 │ │
│ │ szb122041 │ │
│ │ kubelet │ 业务 Pod 主要运行于此 │
│ │ containerd │ │
│ └────────────────┘ │
│ │
│ Harbor 镜像仓库: 192.168.122.156:30000 (HTTP) │
│ (docker.io 镜像已镜像化, 见 ../README.md 同步脚本) │
└───────────────────────────────────────────────────────────────┘节点规划
| 角色 | IP | 主机名 | 规格(建议) | 说明 |
|---|---|---|---|---|
| Master-1 | 192.168.122.38 | szb122038 | 4C/8G/50G | 首个 Server, --cluster-init 初始化 etcd |
| Master-2 | 192.168.122.39 | szb122039 | 4C/8G/50G | Server, 加入 etcd 集群 |
| Master-3 | 192.168.122.40 | szb122040 | 4C/8G/50G | Server, 加入 etcd 集群 |
| Worker-1 | 192.168.122.41 | szb122041 | 8C/16G/100G | Agent, 运行业务负载 |
| API VIP | 192.168.122.43 | — | — | 建议: 浮动地址, 指向健康 Master |
注: 以上 IP 为本手册示例规划（与现有环境 .31~.37 / .156 / .240 不冲突）。 实际部署时请按真实分配替换，全文命令中的 IP 均需同步修改。
关键参数
| 参数 | 值 |
|---|---|
| K3s 版本 | v1.35.4+k3s1 |
| 数据存储 | 内嵌 etcd (3 节点, 法定人数 2) |
| CNI | Flannel (VXLAN, K3s 默认) |
| Pod CIDR | 10.42.0.0/16 (默认) |
| Service CIDR | 10.43.0.0/16 (默认) |
| Ingress | Traefik 3.x (K3s 内置) |
| 镜像仓库 | 192.168.122.156:30000 (Harbor, HTTP) |
| OS | Rocky Linux 9.8, kernel 5.14 |
相关文档
| 文档 | 说明 |
|---|---|
| ../README.md | K3s v1.35.4+k3s1 系统镜像清单与同步脚本 (Harbor) |
| ../../credentials.md | Harbor 等组件登录凭据汇总 |
| ../../k8s-gpu/rancher-deploy-192.168.122.32.md | Rancher 管理平面气隙部署手册 (可作参考) |
| ../../edge/k3s-express-distribution-solution.md | K3s 边缘场景方案 (延伸阅读) |
快速上手路径
- 完全零基础: 从
01文档第 1、2 节读起, 理解 Rancher / K3s / Kubernetes 的关系。 - 只关心怎么用 UI: 集群已建好的话, 直接看
02文档的实操演练。 - 日常值班运维: 把
03文档第 1、2 节 (速查表 + 巡检) 打印出来, 遇到问题查第 10 节。