Vagrant Docker Provider创建K8s节点时网络配置错误求助

核心问题排查 #

错误「配置的网络地址不在定义网络的子网内」本质是：Vagrant给Docker容器分配的静态IP，与指定的Docker网络子网范围不匹配；或是Vagrant未正确定义子网，导致容器IP落到自动分配的其他网段。

具体修复步骤 #

1. 清理旧网络与环境资源
   先删除Vagrant残留的冲突Docker网络，再彻底清理现有Vagrant环境：

   docker network prune -f
   vagrant destroy -f
   

2. 修正Vagrantfile网络配置
   必须明确指定Docker私有网络的子网、网关，同时确保每个节点的静态IP严格落在子网范围内。示例配置：

   # 统一定义子网与网关变量，便于后续维护
   K8S_SUBNET = "192.168.57.0/24"
   K8S_GATEWAY = "192.168.57.1"
   
   # Master节点网络配置
   config.vm.define "k8s-master" do |master|
     master.vm.network "private_network",
       type: "docker",
       ip: "192.168.57.10",
       docker_network__subnet: K8S_SUBNET,
       docker_network__gateway: K8S_GATEWAY
   end
   
   # Node1节点网络配置
   config.vm.define "k8s-node1" do |node1|
     node1.vm.network "private_network",
       type: "docker",
       ip: "192.168.57.11",
       docker_network__subnet: K8S_SUBNET,
       docker_network__gateway: K8S_GATEWAY
   end
   
   # Node2节点网络配置
   config.vm.define "k8s-node2" do |node2|
     node2.vm.network "private_network",
       type: "docker",
       ip: "192.168.57.12",
       docker_network__subnet: K8S_SUBNET,
       docker_network__gateway: K8S_GATEWAY
   end
   

   注意：所有节点的ip必须在K8S_SUBNET（192.168.57.1-254）范围内，不能超出。

3. 同步Ansible Playbook的IP配置
   打开master-playbook.yml，确保所有节点IP相关配置（如主机清单、kubeadm初始化的--apiserver-advertise-address参数）与Vagrantfile里的静态IP完全一致。

4. 重新执行部署
   执行命令从头创建干净环境：

   vagrant up
   

优化建议 #

• 用变量统一管理配置：在Vagrantfile和Ansible Playbook中使用变量定义子网、IP、端口等参数，避免手动修改时出现不一致。比如在Ansible中创建group_vars/all.yml：

  k8s_subnet: 192.168.57.0/24
  master_ip: 192.168.57.10
  node_ips:
    - 192.168.57.11
    - 192.168.57.12
  

• 添加IP合法性检查：在Ansible Playbook开头增加断言任务，提前发现IP配置错误：

  - name: 验证节点IP是否在K8S子网内
    assert:
      that:
        - ansible_default_ipv4.address is ipaddr(k8s_subnet)
      fail_msg: "当前节点IP不在指定子网内，请检查Vagrant网络配置"
  

• 避免端口冲突：如果本地服务占用K8s常用端口（如6443、2379），在Vagrantfile中映射端口时指定宿主机侧的自定义端口：

  master.vm.network "forwarded_port", guest: 6443, host: 16443
  

• 定期清理Docker资源：添加Vagrant provisioner自动清理未使用的Docker资源，避免磁盘占用和配置冲突：

  config.vm.provision "shell", inline: <<-SHELL
    docker system prune -f
  SHELL
  

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