首页/云/Kubernetes 速查/kubectl port-forward 本地端口转发
本包目录(307 条)
kubectl 基础56 条
工作负载36 条网络与服务55 条配置与存储54 条调度与资源52 条集群运维与排障54 条

kubectl port-forward 本地端口转发

在本机与 Pod/Service 之间建立端口隧道,不经过公网即可访问集群内服务;调试数据库、管理端点、临时验证接口的常用手段。

Kubernetes 速查云更新于 2026-10-12
用途本地端口 → Pod/Service 端口的临时隧道
语法kubectl port-forward <pod|svc|deploy>/<名称> <本地端口>:<目标端口>

常用示例

常用示例
kubectl port-forward svc/grafana 8080:3000 -n monitoring
kubectl port-forward pod/web-x 8080:80
kubectl port-forward deploy/web 8080:80
kubectl port-forward svc/web 8080:80 --address=0.0.0.0
转发由 kubectl 进程直接代理,会话结束即断开;svc 目标会随机选择其后端 Pod 之一(单 Pod 连接,无负载均衡)。

易错点

  • 只适合临时调试:进程退出、网络抖动都会断,且 --address=0.0.0.0 会把端口暴露给同网段主机,用完即关
  • 转发到 Service 时不保证每次连的都是同一个 Pod,需要固定后端请指定具体 Pod

数据来源与参考

  • Kubernetes 官方文档 · kubectl port-forward
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌