首页/云/Kubernetes 速查/kubectl proxy 本地访问 API Server
kubectl 基础56 条

kubectl proxy 本地访问 API Server

在本机开一个反向代理端点,自动带上当前 kubeconfig 的认证访问 API Server,便于用 curl/浏览器直接调 REST API 排查。

Kubernetes 速查云更新于 2026-10-12
用途本地免认证访问集群 API(走 kubectl 凭据)
语法kubectl proxy [--port=8001] [--address=127.0.0.1]

常用示例

常用示例
kubectl proxy --port=8001 &
curl -s http://127.0.0.1:8001/api/v1/namespaces/default/pods | head -c 300
curl -s http://127.0.0.1:8001/apis/apps/v1/namespaces/prod/deployments
curl -s http://127.0.0.1:8001/version
proxy 提供的访问不受本地 IP 认证限制(默认只绑 127.0.0.1),等于借用了你的集群权限,用完及时关闭。

易错点

  • 若被其他人能访问到代理端口,相当于免认证 API 入口,--address 不要轻易放开
  • proxy 只做转发不做权限提升,你的账号无权访问的资源同样会返回 403

数据来源与参考

  • Kubernetes 官方文档 · kubectl proxy
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌