port-forward 是什么

port-forward 在本机与集群内的 Pod 或服务之间建立一条端口隧道：kubectl 进程从本机端口接收连接，经过集群接口转发到目标端口。整个过程不依赖集群对外暴露入口，也不需要目标服务配置任何外部访问方式，是调试数据库、管理端点与临时验证接口的常用手段。

它只是临时通道

转发由本机 kubectl 进程直接代理，会话结束或网络抖动就断开，不具备高可用；转发到服务时每次连接只会落到某一个后端 Pod，不经过完整的负载均衡。因此它适合人工验证与临时取数，不适合承载长期流量或用来做压测。

基本信息

典型使用场景

• 连接数据库：把集群内的数据库端口映射到本机，用图形客户端或命令行工具连上去
• 查看监控与仪表盘：临时打开管理界面做配置或排障
• 验证新部署：在服务正式对外之前先在本机确认接口可用
• 调试管理端点：访问只在内部开放的指标与管理路径
• 取数核对：用本机工具连到内部存储做一次性查询
• 排查网络策略：确认从集群外经隧道访问是否与策略预期一致

常用示例

kubectl port-forward pod/web-x 8080:80                       # 固定到某个 Pod
kubectl port-forward svc/db 5432:5432 -n prod                # 转发服务端口
kubectl port-forward deploy/web 8080:80                       # 由控制器挑选副本
kubectl port-forward svc/grafana 3000:3000 -n monitoring      # 打开仪表盘
kubectl port-forward svc/web 8080:80 --address=127.0.0.1      # 显式限制监听地址

目标形式的差异