使用minikube时如何解决外部Jenkins访问Kubernetes API超时问题

• minikube默认启动时，Kubernetes API Server默认监听的是minikube运行时创建的私有虚拟子网IP（也就是报错里的192.168.29.4），该IP仅能在minikube所在的宿主机本地访问，外部托管的Jenkins服务器无法路由到该私有内网地址，因此发起连接请求后出现I/O超时。
• 你在本地配置的代理端口默认绑定的是127.0.0.1地址，仅允许宿主机本地访问，因此外部Jenkins无法通过该代理端口访问API。

方案一：修改minikube启动参数直接暴露API Server #

该方案适配场景：minikube所在宿主机和Jenkins在同一个局域网，或者宿主机有可被Jenkins访问的公网IP

1. 停止当前运行的minikube集群：
   minikube stop
2. 重新启动集群，添加API Server暴露参数：
   minikube start --apiserver-ips=<minikube宿主机可被Jenkins访问的IP地址> --apiserver-port=8443
   参数说明：--apiserver-ips会自动将你指定的宿主机IP加入API Server的证书SAN列表，避免后续访问出现证书不匹配错误
3. 配置minikube宿主机的防火墙/安全组，开放8443端口的入站规则，仅允许Jenkins服务器的IP访问该端口，降低安全风险。
4. 将Jenkins中配置的Kubernetes服务URL替换为https://<宿主机可访问IP>:8443，重新触发构建即可。

方案二：端口转发暴露API #

该方案适配场景：不想修改现有minikube集群配置的情况

1. 在minikube所在宿主机上执行端口转发命令，将API服务转发到宿主机的对外地址：
   使用socat工具的示例命令：
   socat TCP4-LISTEN:8443,fork,bind=<宿主机可被Jenkins访问的IP> TCP4:192.168.29.4:8443
   如果需要后台长期运行，可以添加nohup前缀：
   nohup socat TCP4-LISTEN:8443,fork,bind=<宿主机可被Jenkins访问的IP> TCP4:192.168.29.4:8443 &
2. 开放宿主机8443端口的入站规则，更新Jenkins中的Kubernetes服务URL即可。

跨公网访问补充方案 #

如果Jenkins和minikube所在宿主机不在同一个局域网，也没有公网IP，可以使用内网穿透工具将minikube的8443端口暴露到公网，注意配置IP白名单和身份校验，避免API接口被未授权访问。

配置完成后先在Jenkins所在服务器执行以下命令验证网络连通性：
telnet <你配置的暴露IP> 8443
如果能正常连通，再触发构建任务即可。

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