K3 集群节点突然变成 NotReady - NetworkPluginNotReady

Flannel Pod 未就绪是 CNI 插件异常的主因，需检查其状态、镜像、磁盘、权限、网卡名及后端模式（host-gw 或 VXLAN），验证 CNI 配置与二进制存在性，并通过节点事件、Flannel 日志和 K3s 日志定位根因。

这通常是 CNI 插件（如 Flannel、Calico）未就绪导致的，K3s 默认使用 Flannel，而最常见原因是 Flannel 的 Pod 没起来，或底层网络配置异常。

检查 Flannel Pod 是否正常运行

执行以下命令查看 kube-system 命名空间下的 Flannel 相关 Pod：

• kubectl get pods -n kube-system | grep flannel
• 如果状态是 CrashLoopBackOff、Pending 或 Error，说明 Flannel 启动失败
• 常见原因包括：节点上 /var/lib/rancher/k3s/agent/images/ 目录缺失镜像、磁盘满、cni-bin-dir 权限问题、或主机网络接口名不匹配（如系统用了 enp0s3 而非 eth0）

确认 Flannel 后端类型与主机网络兼容

K3s 默认用 host-gw 模式，要求所有节点在二层互通。若节点跨子网（比如不同 VPC、NAT 环境），需显式启用 VXLAN：

node-connect

诊断Android、iOS及macOS配套应用的OpenClaw节点连接与配对故障，适用于二维码/设置码/手动连接失败或本地Wi-Fi问题时。

下载

• 编辑 /etc/rancher/k3s/config.yaml，添加：
  flannel-backend: vxlan
• 重启 K3s：sudo systemctl restart k3s
• VXLAN 模式对 UDP 8472 端口有依赖，确保防火墙放行该端口（特别是云服务器安全组）

验证 CNI 配置文件和二进制是否存在

K3s 会自动生成 CNI 配置，路径通常为 /etc/cni/net.d/10-flannel.conflist，并把插件二进制放在 /opt/cni/bin/：

• 运行 ls -l /etc/cni/net.d/ 确认配置文件存在且非空
• 运行 ls /opt/cni/bin/flannel* 确认 flannel 插件二进制已部署
• 若缺失，可能是安装时 --disable-agent 或镜像拉取失败；可手动重装：curl -sfL https://get.k3s.io | sh -

查看节点事件和日志定位根因

聚焦关键线索，避免泛查：

• 查节点事件：kubectl describe node <node-name>，重点关注 Events 区域中 “NetworkPluginNotReady” 后面的提示
• 查 Flannel 日志：kubectl logs -n kube-system <flannel-pod-name>
• 查 K3s 服务日志：sudo journalctl -u k3s -n 100 -f，留意启动阶段是否报 “failed to run CNI plugin” 或 “no such device”