Rancher Desktop端口转发失效 本地访问挂起集群内正常如何修复

该故障是Rancher Desktop for macOS的内置端口转发组件存在解析缺陷导致的，核心触发点是你创建的Service使用了命名类型的TargetPort而非数字端口：

• 你的Service配置中TargetPort字段值为ddb-http-port/TCP，是引用Pod定义里的命名端口，没有直接写数字值8000
• 受影响版本的Rancher Desktop端口转发模块无法正确解析命名TargetPort到后端Pod的实际监听端口，会出现「本地端口正常启动监听，但请求无法转发到后端Endpoint」的现象，请求发往本地端口后会因为链路不通一直挂起
• 集群内部访问正常是因为kube-proxy、CoreDNS的原生服务转发逻辑完全支持命名TargetPort，不经过Rancher Desktop的本地转发组件，所以不受该bug影响

按操作成本从低到高可选以下方案：

• 方案1：修改Service配置，将命名TargetPort替换为数字端口，配置片段参考如下：

spec:
  ports:
  - port: 8000
    targetPort: 8000
    protocol: TCP

保存配置后等待3-5秒让Rancher Desktop重载转发规则，再访问本地端口即可正常响应。

• 方案2：弃用Rancher Desktop GUI提供的自动端口转发，使用kubectl原生命令建立转发隧道，绕开存在缺陷的转发组件：

kubectl port-forward svc/ddb 56107:8000

命令执行期间本地56107端口的转发会由kubectl直接维护，不依赖Rancher的转发逻辑，可正常连通服务。

• 方案3：将Rancher Desktop升级到1.12及以上的正式稳定版，新版本已经修复了命名TargetPort的转发解析bug，升级后无需修改现有Service配置即可正常使用自动端口转发。

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