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

Service 端口三件套:port/targetPort/nodePort

分清三个端口是写对 Service 的关键:port 是服务入口,targetPort 是容器监听,nodePort 是节点映射;targetPort 默认等于 port。

Kubernetes 速查云更新于 2026-10-12

端口字段

字段作用默认/备注
portService 在集群内的访问端口必填
targetPort转发到容器的端口(数字或容器端口名)默认与 port 相同
nodePort每个节点上开放的端口(仅 NodePort/LoadBalancer)不写自动分配 30000+

命名端口示例

命名端口示例
spec:
  ports:
    - name: http
      port: 80
      targetPort: web-port     # 引用容器 named port
  selector:
    app: web
targetPort 写错(应用实际监听 8080 却填 80)是「服务有 Endpoints 但连接被拒」的常见原因。

易错点

  • 多端口 Service 必须给每个端口命名(name 字段),否则校验失败
  • named port 依赖 Pod 模板里的容器端口名,改名要同步两端

数据来源与参考

  • Kubernetes 官方文档 · Service(端口定义)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌