Windows 10 Home下Minikube集群Istio网关使用IPv6而非IPv4问题

问题根因 #

• 部署顺序错误：你在执行istioctl install之前就已经提交了Gateway和VirtualService配置，此时Istio的自定义资源还未完成注册，这两份配置不会被Istio控制面识别加载，属于无效资源。
• Windows环境下minikube tunnel的默认端口绑定逻辑会同时监听IPv4和IPv6的环回地址，即便你在网卡和注册表中禁用了IPv6，Windows系统环回接口的IPv6栈优先级仍然高于IPv4，导致443端口被[::1]抢占，127.0.0.1的443端口未正常监听。
• 从你提供的Istio ingressgateway配置来看，服务本身已经配置为IPv4单栈，问题出在外部端口暴露的环节，和Istio本身无关。

解决方案 #

第一步：清理现有无效环境 #

执行以下命令重置当前部署：

# 删除无效的Istio资源
kubectl delete -f gateway.yml
# 删除业务服务
kubectl delete -f service.yml -n abc
# 卸载Istio
istioctl uninstall --purge -y

第二步：按正确顺序重新部署 #

1. 安装Istio，等待所有组件启动完成：

istioctl install --set profile=default -y
kubectl label namespace abc istio-injection=enabled
# 等待Istio所有控制面组件就绪
kubectl wait --for=condition=available deployment --all -n istio-system --timeout=5m

2. 部署业务服务和Istio路由规则：

kubectl apply -f service.yml -n abc
kubectl apply -f gateway.yml

第三步：强制minikube tunnel仅绑定IPv4地址 #

不要直接执行默认的minikube tunnel，增加绑定地址参数：

minikube tunnel --bind-address 127.0.0.1

该参数会强制tunnel仅监听IPv4环回地址，不会创建IPv6的端口监听规则。

如果执行后仍然无法访问，可以给Istio ingressgateway服务添加共享IP注解后重启tunnel：

kubectl annotate service istio-ingressgateway -n istio-system metallb.universe.tf/allow-shared-ip="true"

验证 #

执行以下命令查看443端口的监听情况：

netstat -ano | findstr ":443"

如果返回结果中存在127.0.0.1:443的监听记录，即可通过127.0.0.1:443正常访问Istio网关。

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