document.writeln('');
Flannel Pod 未就緒是 CNI 插件異常的主因,需檢查其狀態、鏡像、磁盤、權限、網卡名及后端模式(host-gw 或 VXLAN),驗證 CNI 配置與二進制存在性,并通過節點事件、Flannel 日志和 K3s 日志定位根因。

這通常是 CNI 插件(如 Flannel、Calico)未就緒導致的,K3s 默認使用 Flannel,而最常見原因是 Flannel 的 Pod 沒起來,或底層網絡配置異常。
執行以下命令查看 kube-system 命名空間下的 Flannel 相關 Pod:
kubectl get pods -n kube-system | grep flannelK3s 默認用 host-gw 模式,要求所有節點在二層互通。若節點跨子網(比如不同 VPC、NAT 環境),需顯式啟用 VXLAN:
/etc/rancher/k3s/config.yaml,添加:flannel-backend: vxlansudo systemctl restart k3sK3s 會自動生成 CNI 配置,路徑通常為 /etc/cni/net.d/10-flannel.conflist,并把插件二進制放在 /opt/cni/bin/:
ls -l /etc/cni/net.d/ 確認配置文件存在且非空ls /opt/cni/bin/flannel* 確認 flannel 插件二進制已部署curl -sfL https://get.k3s.io | sh -聚焦關鍵線索,避免泛查:
kubectl describe node <node-name>,重點關注 Events 區域中 “NetworkPluginNotReady” 后面的提示kubectl logs -n kube-system <flannel-pod-name>sudo journalctl -u k3s -n 100 -f,留意啟動階段是否報 “failed to run CNI plugin” 或 “no such device”