K3s 多节点集群踩坑记录

记录在树莓派 + VM 混合环境下搭建 K3s 集群时遇到的各种坑。

环境

• Master: VM 2C4G Ubuntu 22.04
• Worker x2: 树莓派 4B 4GB

踩坑记录

Flannel nftables CIDR 不匹配

K3s 分配的 Pod CIDR 是 10.42.0.0/16，但 Flannel 的 nftables 规则硬编码了 10.244.0.0/16，导致 Pod 间流量全部被 DROP。

修复：

nft add rule ip filter FLANNEL-FWD ip saddr 10.42.0.0/16 accept
nft add rule ip filter FLANNEL-FWD ip daddr 10.42.0.0/16 accept

containerd 镜像拉取超时

国内环境拉取 k8s.gcr.io 镜像几乎不可能，改用阿里云镜像加速：

# /etc/rancher/k3s/registries.yaml
mirrors:
  docker.io:
    endpoint:
      - "https://dockerproxy.net"
      - "https://docker.1ms.run"
      - "https://docker.xuanyuan.me"

---

待完善，2026-04-08