无法通过NodePort访问部署在Kubernetes上的MinIO（浏览器端）

1. 确认NodePort的实际暴露端口 #

Kubernetes会自动分配NodePort（若未手动指定），务必使用Service实际分配的端口，而非容器的targetPort。执行命令查看：

kubectl get svc <minio-service-name>

查看输出的PORT(S)列，例如9000:30123/TCP，其中30123才是用于外部访问的NodePort。

2. 验证minikube节点的网络连通性 #

• 先获取minikube节点IP：

minikube ip

• 在本地机器ping该IP，若无法连通，检查minikube网络驱动：

minikube config get driver

若为docker驱动，可尝试用minikube service <minio-service-name>直接唤起浏览器访问，同时排查本地防火墙是否拦截了minikube的网络请求。

3. 核对端口映射一致性 #

确认Deployment的容器端口与Service的targetPort完全匹配：

• 查看Deployment端口配置：

kubectl describe deployment <minio-deployment-name> | grep -A 10 "Ports"

• 查看Service的targetPort：

kubectl describe svc <minio-service-name> | grep "TargetPort"

需保证端口数值、协议（TCP/UDP）完全一致。

4. 检查MinIO启动参数 #

MinIO默认需指定--console-address才能暴露Web控制台，仅启动API端口无法通过浏览器访问。修改Deployment的容器启动命令，添加控制台端口参数：

command: ["minio"]
args: ["server", "/data", "--console-address", ":9001"]

同步更新Service，将9001端口也映射为NodePort，之后重启Deployment：

kubectl rollout restart deployment <minio-deployment-name>

5. 排查本地防火墙/安全组限制 #

NodePort默认范围为30000-32767，需确保本地防火墙开放该端口段：

• Linux系统：

sudo iptables -A INPUT -p tcp --dport 30000:32767 -j ACCEPT

• macOS系统：
  进入「系统设置-网络-防火墙」，确认允许minikube相关的网络请求。

6. 验证Pod内部服务状态 #

进入MinIO Pod，测试本地访问是否正常：

kubectl exec -it <minio-pod-name> -- curl http://localhost:9000

若返回MinIO相关响应，说明Pod内部服务正常；若报错，查看Pod日志排查启动问题：

kubectl logs <minio-pod-name>

7. 用minikube命令验证访问路径 #

执行以下命令获取minikube生成的可访问URL，直接访问测试：

minikube service <minio-service-name> --url

若此URL可正常访问，说明是本地IP访问的网络驱动限制问题，可基于该URL做后续适配。

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