Linux 上安装 Kubernetes 的关键注意事项
一 环境预检与系统要求
- 硬件基线：每个节点至少2 核 CPU、2 GB 内存（生产建议≥4 GB），并预留≥20 GB 磁盘空间，保证控制面与工作负载稳定运行。
- 主机标识唯一：确保各节点主机名、MAC 地址、product_uuid唯一，避免因识别冲突导致节点注册异常。
- 网络互通：所有节点之间（公网或内网）需互相可达，并规划好后续 Pod 网络 CIDR，避免与宿主机网段冲突。
- 组件版本：提前确定 Kubernetes 版本与 kubelet/kubeadm/kubectl 的版本一致性，减少兼容性问题。
二 内核与系统参数
- 禁用 Swap：必须关闭 swap，临时执行
swapoff -a，并在 /etc/fstab 中注释 swap 项，确保重启后仍生效。
- 加载内核模块与网络参数：启用
overlay、br_netfilter，并开启桥接流量到 iptables 的钩子，保证 Pod 间与 Service 流量转发正常。
- iptables 后端：确保系统使用 iptables 而非 nftables 后端，避免 kube-proxy/网络插件兼容性问题。
- 系统调优：按需开启
net.ipv4.ip_forward=1 等转发与连接跟踪参数，提升网络与 Service 可达性。
三 容器运行时与 kubeadm 配置
- 容器运行时：Kubernetes 通过 CRI 与容器运行时交互，常见选择为 containerd（推荐）或 Docker（需配置其 CRI 支持）。安装后确认运行时健康与版本匹配。
- cgroup 驱动一致：确保 kubelet 与容器运行时使用相同的 cgroup 驱动（如 systemd 或 cgroups v1），否则节点可能 NotReady。
- kubeadm 初始化：使用
kubeadm init 时显式指定 --pod-network-cidr，并与所选网络插件（如 Flannel、Calico）的默认网段保持一致；初始化前会进行 pre-flight checks，务必逐项通过。
四 网络与端口规划
- 放行必要端口：控制面与工作节点间需开放关键端口，例如 TCP 6443（API Server）、2379–2380（etcd）、10250–10252（kubelet、kube-scheduler、kube-controller-manager 等），以及 kube-proxy 与网络插件所需端口。
- 节点多网卡：若存在多个网络接口，预先配置路由规则，确保控制面与 Pod 流量走期望的网卡与出口。
- 网络插件：初始化完成后尽快部署 Pod 网络插件（如 Flannel、Calico），否则节点将持续 NotReady。
五 安全加固与常见排错
- 安全策略：生产环境不建议直接关闭防火墙与 SELinux，应按需放行端口并采用最小权限原则；调试阶段可临时关闭以加速排障。
- 镜像与仓库：为加速与稳定性，可配置国内镜像源或私有仓库，确保
kubeadm init 能拉取所需镜像。
- 快速排错路径：
- 节点状态异常：使用
kubectl get nodes 与 kubectl describe node <node> 查看条件与事件；
- Pod 启动失败：使用
kubectl describe pod <pod> 与 kubectl logs <pod> 定位镜像、挂载、权限等问题；
- 端口连通性：使用
nc -zv <ip> <port> 或 ss -lntp | grep <port> 检查端口监听与连通性。
- 安装方式选择：除
kubeadm 外，也可在 Ubuntu 上使用 MicroK8s 快速搭建单节点或轻量集群，便于开发测试与功能验证。