WSL2多节点部署Kubernetes：私有IP不可达问题求解

方法1：给WSL2配置静态IP并打通宿主网络路由 #

WSL2默认用NAT网络，私有IP无法被外部访问，先给每个WSL2实例配置静态IP，再打通宿主到WSL2的流量转发：

• 第一步：WSL2内部配置静态IP
  编辑/etc/wsl.conf，添加以下内容禁用自动生成的网络配置：

  [network]
  generateResolvConf = false
  

  执行wsl --shutdown关闭所有WSL2实例，重新打开后新建/编辑/etc/netplan/00-installer-config.yaml：

  network:
    ethernets:
      eth0:
        addresses: [192.168.50.10/24] # 选一个独立网段或和宿主同网段的静态IP
        gateway4: 192.168.50.1 # 对应后续宿主虚拟网卡的IP
        nameservers:
          addresses: [8.8.8.8, 1.1.1.1]
    version: 2
  

  应用配置：sudo netplan apply

• 第二步：宿主机器配置路由转发
  打开管理员命令行，执行：

  # 给WSL虚拟网卡设置对应静态IP
  netsh interface ip add address "vEthernet (WSL)" 192.168.50.1 255.255.255.0
  # 开启该网卡的IP转发功能
  netsh interface ipv4 set interface "vEthernet (WSL)" forwarding=enabled
  # 添加永久路由，让外部机器访问WSL网段时指向宿主
  route add 192.168.50.0 mask 255.255.255.0 192.168.50.1 -p
  

  若其他机器不在同一局域网，需在路由器添加静态路由，指向宿主机器的公网/局域网IP。

• 第三步：指定静态IP部署K8s
  初始化控制平面时，绑定WSL2的静态IP：

  kubeadm init --apiserver-advertise-address=192.168.50.10 --apiserver-bind-port=6443 --pod-network-cidr=10.244.0.0/16
  

  工作节点直接用这个静态IP加入控制平面，无需依赖宿主IP，避免节点IP验证错误。

方法2：Windows 11+ 使用WSL2网桥模式（推荐） #

Windows 11 22H2及以上版本支持WSL2直接使用网桥网络，让WSL2获取和宿主同一网段的IP，直接被外部机器访问：

• 第一步：宿主机器创建网桥
  打开「网络和共享中心」→「更改适配器设置」，选中物理网卡（Wi-Fi/以太网）右键选择「桥接」，等待系统自动创建网桥。

• 第二步：配置WSL2使用网桥
  在宿主用户目录下创建.wslconfig文件，添加：

  [wsl2]
  networkingMode=bridge
  vmSwitch=网桥 # 填你创建的网桥名称，默认叫"网桥"
  

  执行wsl --shutdown重启WSL2，重新打开后WSL2会自动获取和宿主同网段的IP。

• 第三步：部署K8s
  初始化控制平面时，直接用WSL2的网桥IP：

  kubeadm init --apiserver-advertise-address=$(hostname -I | awk '{print $1}') --pod-network-cidr=10.244.0.0/16
  

  工作节点用这个IP直接加入，跨节点网络互通问题直接解决。

方法3：绕过K8s节点IP验证（应急方案，不推荐） #

如果必须使用宿主IP，可修改K8s组件参数跳过节点IP验证：

• 修改kubelet配置：
  编辑/var/lib/kubelet/config.yaml，添加宿主IP：

  nodeIP: 192.168.0.100 # 替换为你的宿主IP
  

  编辑kubelet启动配置/etc/systemd/system/kubelet.service.d/10-kubeadm.conf，添加跳过验证的参数：

  Environment="KUBELET_EXTRA_ARGS=--node-ip=192.168.0.100 --skip-node-ip-validation"
  

  重启kubelet：sudo systemctl daemon-reload && sudo systemctl restart kubelet

• 修改控制平面apiserver配置：
  编辑/etc/kubernetes/manifests/kube-apiserver.yaml，确保--advertise-address设置为宿主IP，工作节点加入时使用宿主IP+转发的端口：

  kubeadm join 192.168.0.100:6443 --token xxx --discovery-token-ca-cert-hash sha256:xxx
  

  注意：此方法可能引发K8s内部网络异常（如节点健康检查、Pod路由问题），仅作为临时应急方案。

内容的提问来源于stack exchange，提问作者mentics