首页/云/Kubernetes 速查/NodePort 端口范围与分配策略
网络与服务55 条

NodePort 端口范围与分配策略

默认范围 30000-32767,由 apiserver 参数控制;可指定固定 nodePort 也可自动分配,端口是集群级资源需要台账管理。

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

查看与修改范围(控制面配置)

查看与修改范围(控制面配置)
ps -ef | grep kube-apiserver | grep -o -- '--service-node-port-range=[0-9-]*'
# kubeadm 集群:/etc/kubernetes/manifests/kube-apiserver.yaml 中修改后再滚动生效

固定端口示例

固定端口示例
spec:
  type: NodePort
  ports:
    - port: 443
      targetPort: 8443
      nodePort: 30443
固定 nodePort 便于防火墙白名单与外部 LB 配置;范围调整属于控制面变更,需重启 apiserver。

易错点

  • 指定范围外的 nodePort 会被校验拒绝;范围被修改过的老集群要按实际配置来
  • 固定端口是全局资源,两个 Service 抢同一 nodePort 时后创建的失败

数据来源与参考

  • Kubernetes 官方文档 · Service(nodePort 范围)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌