Minikube部署ASP.NET应用后NodePort端口无法访问问题

操作步骤 #

1. 创建Dockerfile：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
EXPOSE 80
EXPOSE 443
# omitted

FROM base AS final
# omited
ENTRYPOINT [ "dotnet", "Application.dll", "--urls http://0.0.0.0:80;https://0.0.0.0:443" ]

2. Windows PowerShell中切换Docker环境到Minikube：

& minikube -p minikube docker-env --shell powershell  | Invoke-Expression

3. 部署资源YAML：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: identities-deployment
  labels:
    app: identities
spec:
  replicas: 1
  selector:
    matchLabels:
      app: identities
  template:
    metadata:
      labels:
        app: identities
    spec:
      containers:
      - name: identities
        image: identities-service:latest
        imagePullPolicy: Never
        ports:
        - containerPort: 80
        - containerPort: 443
---
apiVersion: v1
kind: Service
metadata:
  name: identities-service
spec:
  type: NodePort
  selector:
    app: identities
  ports:
    - protocol: TCP
      port: 80
      targetPort: 80
      nodePort: 30001
      name: http
    - protocol: TCP
      port: 443
      targetPort: 443
      nodePort: 30002
      name: https

4. 获取Minikube IP：minikube ip 返回 192.168.49.2
5. 向 192.168.49.2:30001 发送请求超时
6. 进入应用容器内部，curl localhost:80 返回200，应用正常：

kubectl exec --stdin --tty identities-deployment-d794d7866-6bnhn -- /bin/bash
curl localhost:80

7. 进入Minikube容器内部，curl localhost:30001 返回200：

docker exec -it 46cca50fc3b3 sh 
curl localhost:30001

8. 执行 minikube service identities-service --url 得到：

http://127.0.0.1:51504
http://127.0.0.1:51505
❗  Because you are using a Docker driver on windows, the terminal needs to be open to run it.

9. 向 localhost:51504 发送请求返回200

Minikube容器端口映射情况：

CONTAINER ID   IMAGE                                 COMMAND                  CREATED          STATUS
    PORTS
                      NAMES
46cca50fc3b3   gcr.io/k8s-minikube/kicbase:v0.0.39   "/usr/local/bin/entr…"   55 minutes ago   Up 55 minutes
    127.0.0.1:58799->22/tcp, 127.0.0.1:58800->2376/tcp, 127.0.0.1:58802->5000/tcp, 127.0.0.1:58803->8443/tcp, 127.0.0.1:58801->32443/tcp   minikube

问题 #

1. 步骤5中请求超时的原因是什么？
2. 如何解决该问题以实现通过30001端口直接访问应用？
3. 51504这类临时端口的来源是什么？
4. 是否需要将30001、30002端口映射到本地机器？若需要，该如何配置？

1. 请求超时的原因 #

你使用的是Windows环境下的Docker驱动Minikube，Minikube的节点IP 192.168.49.2 属于Docker内部私有网络，本地Windows主机不在该网络段内，无法直接访问这个IP的端口，因此请求超时。

2. 实现通过30001端口直接访问的方法 #

有两种可靠方案：

• 方案一：使用Minikube Tunnel
  执行命令：

  minikube tunnel
  

  该命令会在本地创建网络路由，让你可以直接通过Minikube节点IP访问NodePort或LoadBalancer类型的Service，保持终端窗口打开即可。
• 方案二：创建本地端口转发
  用kubectl直接将本地端口与Service的NodePort绑定：

  kubectl port-forward service/identities-service 30001:30001 30002:30002
  

  执行后，本地localhost:30001会直接映射到Minikube内部的30001端口，请求即可正常响应。

3. 临时端口（如51504）的来源 #

minikube service --url 命令会自动创建临时本地端口转发：它将Minikube内部Service的端口（这里是NodePort的30001）随机映射到本地Windows的一个临时端口（51504），这个转发是会话级的，关闭执行命令的终端后就会失效，本质是帮你省去手动执行kubectl port-forward的步骤。

4. 是否需要映射30001/30002到本地？如何配置？ #

如果需要固定用30001/30002端口从本地访问，是需要做映射的，有三种配置方式：

• 方式一：启动Minikube时指定端口映射
  重启Minikube时添加端口映射参数，直接把Minikube容器的30001/30002端口映射到本地相同端口：

  minikube stop
  minikube start --ports=30001:30001 --ports=30002:30002
  

  启动后，本地就可以直接通过localhost:30001访问。
• 方式二：手动创建固定端口转发
  执行kubectl命令，将本地端口与Service的目标端口绑定（不需要依赖NodePort）：

  kubectl port-forward service/identities-service 30001:80 30002:443
  

  这里本地30001对应Service的80端口（即容器的80端口），30002对应443端口，这种方式不需要提前指定NodePort，灵活度更高。
• 方式三：使用LoadBalancer类型Service配合Tunnel
  修改Service的type为LoadBalancer，然后执行minikube tunnel，Minikube会分配一个本地可访问的固定IP，通过该IP的80/443端口即可访问应用，适合需要对外提供稳定访问入口的场景。

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