无法通过端口转发访问运行中Kubernetes Deployment的Pod

核心问题定位 #

• 端口完全不匹配：Docker中NodeRed实际监听1880端口，但Deployment配置里写的containerPort是1881，且端口转发命令错误指向了Pod的443端口，三者完全不对应。
• hostNetwork配置误区：开启hostNetwork: true后，Pod直接占用宿主机网络端口，若容器实际未监听配置的端口，或宿主机端口冲突，会直接导致访问失败，同时也会干扰端口转发的正常逻辑。

分步解决方案 #

步骤1：修正Deployment配置 #

匹配Docker中NodeRed的实际监听端口，同时移除不必要的hostNetwork: true（非必要场景不建议开启，易引发端口冲突）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nodered2
  labels:
    app: nodered2
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nodered2
  template:
    metadata:
      labels:
        app: nodered2
    spec:
      containers:
      - name: nodered2
        image: localhost:1881/nodered2
        imagePullPolicy: IfNotPresent
        ports:
        - containerPort: 1880  # 与Docker中NodeRed监听端口保持一致

步骤2：重新部署应用 #

执行命令更新Deployment并等待Pod就绪：

kubectl apply -f <你的Deployment文件名>.yaml
kubectl rollout status deployment/nodered2

步骤3：正确执行端口转发 #

将本地端口映射到容器的1880端口：

kubectl port-forward deployment/nodered2 1880:1880

完成后直接访问http://localhost:1880即可。

备选方案：若必须使用hostNetwork #

如果业务需要开启宿主机网络：

1. 确认宿主机1880端口未被其他进程占用
2. 无需执行端口转发，直接访问http://localhost:1880（Pod已直接使用宿主机网络端口）
3. 若宿主机端口冲突，需修改NodeRed监听端口（通过环境变量或配置文件），同步更新Deployment的containerPort

额外排查手段 #

若仍无法访问，执行以下命令定位问题：

• 查看Pod日志，确认NodeRed是否正常启动并监听端口：

  kubectl logs deployment/nodered2
  

• 进入Pod内部，检查端口监听状态：

  kubectl exec -it deployment/nodered2 -- netstat -tulpn
  

• 查看Pod详细状态与事件：

  kubectl describe pods -l app=nodered2
  

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