Minikube中Ingress配置无效问题排查求助

问题背景 #

按照Kubernetes官方文档配置Minikube Ingress完成hello-world示例后，通过配置的主机名hello-world.info无法访问服务，但使用minikube service web -n hello或端口转发可以正常访问，且kubectl get ingress显示Ingress的ADDRESS字段为空。

已执行操作 #

# 启用Ingress插件
minikube addons enable ingress
# 查看Ingress Controller Pod状态
kubectl get pods -n ingress-nginx

输出：

NAME                                        READY   STATUS      RESTARTS   AGE
ingress-nginx-admission-create-5pthd        0/1     Completed   0          137m
ingress-nginx-admission-patch-h9vrh         0/1     Completed   1          137m
ingress-nginx-controller-56cf58c77c-9rnr6   1/1     Running     0          137m

# 创建命名空间与部署
kubectl create ns hello
kubectl create deployment web --image=gcr.io/google-samples/hello-app:1.0 -n hello
kubectl expose deployment web --type=NodePort --port=8080 -n hello
# 查看Service状态
kubectl get service web -n hello

输出：

NAME   TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
web    NodePort   10.96.235.52   <none>        8080:30282/TCP   61s

# 应用官方Ingress示例文件
kubectl apply -f https://k8s.io/examples/service/networking/example-ingress.yaml -n hello
# 查看Ingress状态
kubectl get ingress -n hello

输出：

NAME              CLASS    HOSTS              ADDRESS   PORTS   AGE
example-ingress   <none>   hello-world.info             80      35s

本地/etc/hosts已添加配置：

192.168.49.2 hello-world.info

排查与解决步骤 #

1. 等待Ingress地址分配 #

Ingress的ADDRESS字段为空说明Ingress Controller尚未完成地址绑定，执行以下命令实时监控Ingress状态，等待地址出现：

kubectl get ingress -n hello -w

通常需要1-2分钟完成同步，若长时间无地址，重启Ingress Controller Pod：

kubectl rollout restart deployment ingress-nginx-controller -n ingress-nginx

2. 指定Ingress Class #

Minikube的Ingress Controller默认使用nginx类，而官方示例Ingress未指定ingressClassName，导致规则无法关联到Controller。修改Ingress配置文件，添加ingressClassName字段：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$1
spec:
  ingressClassName: nginx  # 添加该行
  rules:
  - host: hello-world.info
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: web
            port:
              number: 8080

保存为modified-ingress.yaml后重新应用：

kubectl apply -f modified-ingress.yaml -n hello

3. 验证Ingress Controller日志 #

查看Ingress Controller日志，排查是否有规则加载错误：

kubectl logs -n ingress-nginx $(kubectl get pods -n ingress-nginx -l app.kubernetes.io/name=ingress-nginx -o name)

若日志中出现no ingress class matched类错误，说明Ingress Class配置不匹配，需确保ingressClassName与Controller的类一致。

4. 内部访问测试 #

进入Minikube节点，直接测试Ingress是否生效：

minikube ssh
curl hello-world.info

若能返回hello-world内容，说明Ingress配置正常，问题出在本地网络或浏览器缓存；若仍无法访问，检查Ingress规则与Service的关联是否正确。

5. 本地环境排查 #

• 重新验证Minikube IP：执行minikube ip确认/etc/hosts中的IP与输出一致
• 清理浏览器缓存或使用curl hello-world.info测试，排除浏览器缓存干扰
• 检查本地防火墙是否放行80端口

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